Bootpay 결제 매뉴얼

마켓플레이스

리셀러 가입·유형

리셀러 계정을 가입 화면(https://admin.bootpay.co.kr/join/reseller)에서 만들고 유형을 고릅니다. 리셀러 계정을 만드는 공개 API 는 없습니다.

가입 순서

  1. 가입 화면에서 이용 방법을 고릅니다. 「결제와 알림톡을 함께」 또는 「알림톡만」입니다.
  2. 결제를 함께 쓰면 유형을 고릅니다.
  3. 로그인합니다. 부트페이 계정이 없으면 여기서 만듭니다.
  4. 리셀러명·사업자등록번호·대표 전화번호·담당자명·이메일·전화번호·프로젝트 이름을 넣고, 알림톡 이용료를 누가 낼지 고릅니다. 홈페이지는 선택입니다.
  5. 만들기를 마치면 리셀러 관리자 첫 화면으로 들어갑니다.

승인 절차 없이 만든 즉시 리셀러 API 를 호출할 수 있습니다. 부트페이가 사용을 멈춘 계정만 RESELLER_SUSPENDED(HTTP 403)로 막힙니다.

첫 API 호출

리셀러 관리자 콘솔의 개발자 설정 > 결제 연동키 에서 서버 키를 발급합니다. 화면 사용법은 연동키 발급 과 같습니다. 그 키로 리셀러 내 정보(GET /v2/reseller/me)를 불러 reseller_contract.type(유형)·reseller_contract.message_billing_payer(대납 옵션)를 확인합니다.

RESELLER_AUTH=$(printf '%s' "$BOOTPAY_RESELLER_CLIENT_KEY:$BOOTPAY_RESELLER_SECRET_KEY" | base64)

curl "https://api.bootpay.co.kr/v2/reseller/me" \
  -H "Authorization: Basic $RESELLER_AUTH"bash

그다음 가맹점 생성 으로 하위 가맹점을 만듭니다. 필요한 API 만 허용한 키를 쓰려면 범위 키(리셀러 스코프) 를 봅니다.

유형

B형 영업대행 A형 대표가맹점
판매 대금 PG사가 판매자에게 바로 보냅니다 리셀러가 대표 가맹점으로 받아 판매자에게 나눠 줍니다(지급대행). 나눠 주는 기능은 준비 중입니다
PG 가맹 하위 가맹점이 각자 합니다 리셀러 본인이 관리자 콘솔 「내 PG › PG 신청」에서 합니다
지금 쓸 수 있는 것 등록 폼·등록 API 로 하위 가맹점의 PG 가맹 신청 받기, 하위 가맹점 만들기, 결제수단·연동 키·알림톡 관리 리셀러 본인의 PG 가맹, 하위 가맹점 만들기, 결제수단·연동 키·알림톡 관리
준비 중 리셀러피 정산·명세 하위 가맹점을 대표 MID 아래 하위몰로 등록, 하위 가맹점 정산·지급대행
안 되는 것 대표 가맹점으로 판매 대금을 받아 나눠 주기 하위 가맹점의 PG 가맹 신청(등록 폼·등록 API)
  • 등록 폼이나 등록 API 를 A형 계정으로 부르면 ONBOARDING_KIND_TYPE_MISMATCH(8168, HTTP 403)입니다.
  • 「알림톡만」을 고르면 A형으로 만들어집니다. 나중에 결제가 필요하면 부트페이에 알립니다.
  • reseller_contract.type 이 null 이면 유형이 생기기 전에 가입한 계정이고, B형으로 동작합니다.

만든 뒤 바꾸기

유형과 알림톡 이용료 대납 옵션은 가입 때 고르고, 그 뒤에는 부트페이만 바꿀 수 있습니다.

바꿀 것 방법
유형 부트페이에 문의합니다
알림톡 이용료 대납 옵션 부트페이에 문의합니다
웹훅 주소·이벤트 리셀러 웹훅 API 로 직접 바꿉니다

함께 보기