← 모든 튜토리얼

튜토리얼 10 / 10

여러 판매자를 위한 결제를 받으세요.

고객 결제 한 번, 판매자별 잔액과 관리되는 지급.

완료 후 갖게 되는 것

판매자 3명, 수수료 4%, 검토된 지급 정책을 사용하는 체크아웃.

1. 프로젝트 준비

프로젝트 → Marketplace → 설정에서 켜고 스토어를 선택하세요. 지급은 일시 중지해 두세요. 프로젝트 지갑을 백업하고 각 스토어에 Bitcoin 또는 지원 EVM 방식을 켜세요.

고객은 이 프로젝트 지갑에 먼저 결제해요. 키를 관리하는 당신은 기록된 잔액을 판매자에게 지급할 의무가 있어요. 비용용 자유 네이티브 코인을 별도 준비하세요. 일반 스윕은 Marketplace 주소를 쓰지 못해요.

2. 판매자 3명 추가 및 승인

판매자 화면에서 각 판매자와 Bitcoin 메인넷 주소를 추가하세요. 승인 전 판매자와 별도 경로로 확인하세요. EVM 토큰은 정확히 같은 네트워크의 승인 주소가 필요해요.

프로젝트 수수료를 4%로 설정하세요. 스토어·판매자·승인된 청구서 재정의는 저장되므로 나중에 바꿔도 기존 배분은 변하지 않아요.

3. 통합 청구서 만들기

Marketplace → 청구서에서 300 USD 청구를 만들고 총 몫을 각 100 USD씩 3개 지정하세요. 합계가 정확해야 해요. 결제 링크를 고객에게 보내세요.

API 연결은 별도 Marketplace 키를 쓰고 십진 문자열을 다음 주소로 보내세요: /v1/marketplace/invoices. 요청 전에 멱등 키를 저장하고 시간 초과 뒤에도 재사용하세요. 요청 예제 →

4. 검토 후 보내기

검증된 배분이 사용 가능해질 때까지 기다리세요. 고정 견적에서 판매자마다 96 USD 상당을 받고 수수료 12 USD 상당이 남아요. 처리 수수료가 1%면 선불 크레딧 3 USD를 써요. 체인 비용은 별도예요.

지급 화면에서 가용 배분을 준비하고 네이티브 수수료와 가스 한도를 정하세요. Bitcoin은 선택 청구서의 모든 미지급 몫을 같은 배치에 넣어야 해요. 정확한 수취인과 계획을 검토하고 한 번 승인한 뒤 Broadcast가 아닌 Paid까지 확인하세요.

5. 신중하게 자동화 켜기

설정에서 자산별 최소 지급, 건별·일일 원금 한도, 네이티브 비용과 가스 예산, 간격, 확인 횟수를 정하세요. 한도와 주소 검토 후 켜고 지급 일시 중지를 해제하세요.

자동 정책은 추가 클릭 없이 보낼 수 있어요. 크레딧 부족이나 서버 전송 제한은 지출을 멈추지만 관찰과 장부는 계속돼요.

6. 중복 전송 없이 예외 처리

  • 부족 결제: 허용 오차가 없는 자금을 만들지는 않아요. 추가 결제를 기다리거나 환불하거나 실제로 충당되는 더 작은 배분을 승인하세요.
  • 토큰 가스 부족: 자유 네이티브 코인을 지갑에 넣고 저장된 지급을 검토하세요. 우회하려고 두 번째 지급을 만들지 마세요.
  • Webhook 시간 초과: 같은 서명 이벤트를 재시도하세요. 원문 서명과 프로젝트를 확인하고 event_id를 고유 저장한 뒤 응답하세요. 청구서 정산 이벤트는 판매자 지급 완료가 아니에요.
  • 판매자 지급 후 환불: 기본 주소에 별도 자금을 넣고 고객 주소를 확인한 뒤 같은 자산 전액 환불을 준비·승인하세요. 판매자에게 자동 청구하지 않아요.
  • 복원 또는 방송 불확실: 지급을 일시 중지하고 보관된 해시를 대사한 뒤 재개하세요. 시간 초과가 미전송을 뜻한다고 가정하지 마세요.

운영 참고 · API, 권한과 이벤트