등록 상태 조회

하위 가맹점 한 곳의 PG 가맹 신청서를 최신순으로 읽는다. 각 항목의 값은 리셀러 웹훅 의 data 와 같은 이름이라, 웹훅을 놓쳤거나 순서가 뒤바뀌었을 때 이 API 로 최신 상태를 다시 맞춘다.

핵심 요약

• 그 가맹점의 신청서를 전부 보여 준다. 리셀러가 발급한 등록 폼으로 낸 신청(channel=hosted)뿐 아니라 판매자가 부트페이 콘솔에서 직접 낸 신청(console)도 나온다.
• 최신순 20건까지. onboarding_id 를 주면 그 1건만 온다.
• 신청이 없으면 {"list": []} 로 200 이다.
• 본사 담당자의 메모·연락 기록·제출 서류·담당자 연락처는 내려 주지 않는다.

API 정보

요청 파라미터

코드 예제

import fetch from 'node-fetch'

const RESELLER_AUTH = 'Basic ' + Buffer
  .from(`${process.env.BOOTPAY_RESELLER_CLIENT_KEY}:${process.env.BOOTPAY_RESELLER_SECRET_KEY}`)
  .toString('base64')

const providerId = '65a1c0aa8f1b5b00367a0001'
const res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/${providerId}/onboarding`, {
    headers: { 'Authorization': RESELLER_AUTH }
})
const { list } = await res.json()
console.log(list[0]?.stage, list[0]?.stage_owner)javascript

import base64, os, requests

auth = 'Basic ' + base64.b64encode(
    f"{os.environ['BOOTPAY_RESELLER_CLIENT_KEY']}:{os.environ['BOOTPAY_RESELLER_SECRET_KEY']}".encode()
).decode()

provider_id = '65a1c0aa8f1b5b00367a0001'
res = requests.get(
    f'https://api.bootpay.co.kr/v2/reseller/seller/{provider_id}/onboarding',
    headers={'Authorization': auth}
)
print(res.json()['list'])python

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

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

응답

{
  "list": [
    {
      "provider_id":        "65a1c0aa8f1b5b00367a0001",
      "onboarding_id":      "6718a0aa8f1b5b00367a0101",
      "kind":               "pg_join",
      "status":             1,
      "status_name":        "구비서류 전달 필요",
      "stage":              "doc_wait",
      "stage_owner":        "merchant",
      "due_at":             "2026-10-30T18:00:00+09:00",
      "reject_reason":      null,
      "pg_wait_id":         "6718a0aa8f1b5b00367a0101",
      "pg":                 "nicepay",
      "overdue":            false,
      "required_documents": ["doc"],
      "channel":            "hosted",
      "c_at":               "2026-10-27T10:00:00+09:00",
      "u_at":               "2026-10-27T11:20:00+09:00"
    }
  ]
}json

응답 파라미터

단계 표

doc_wait 이면 판매자에게 보완을 안내한다. 고친 신청서는 같은 onboarding_id 로 mode=edit 세션을 발급 해 다시 내게 한다.

에러 코드