PG 가맹 신청

아직 MID 가 없는 하위 판매자의 PG 가맹 신청을 받습니다. 화면이 필요하면 등록 폼을, 이미 받은 정보로 낼 때는 등록 API 를 사용합니다. B형(영업대행) 리셀러만 쓸 수 있습니다 — 리셀러 가입·유형.

인증·권한 오류는 각 표에 없어도 공통 오류 가 날 수 있습니다.

1등록 폼 세션 발급

하위 가맹점 한 곳의 PG 가맹 신청 화면(등록 폼)을 열 수 있는 토큰을 발급합니다. 받은 token 을 등록 폼 열기 (JS SDK) 에 넘기거나 url 을 그대로 열면, 판매자는 부트페이 계정 없이 신청서를 작성해 접수합니다.

동작 규칙

• 토큰은 하위 가맹점 1곳 · 30분 · 접수 1회​​로 묶입니다. 접수하면 소진되고, 30분이 지나면 열리지 않습니다.
• 토큰 평문은 이 응답에서만 나옵니다. 부트페이는 해시만 저장하므로 다시 조회할 수 없습니다. 필요하면 새로 발급합니다.
• 같은 하위 가맹점·같은 종류로 다시 발급하면 아직 쓰지 않은 이전 토큰은 바로 만료됩니다.
• 지금 열 수 있는 종류(kind)는 pg_join(PG 가맹 신청) 하나입니다.
• 신청 단계가 바뀔 때마다 리셀러 웹훅 이 오고, 놓친 단계는 등록 상태 조회 로 다시 맞춥니다.

API 정보

1-1. 요청 파라미터

prefill·locked 에 쓸 수 있는 키는 아래와 같습니다. 이 밖의 키를 보내면 400 ONBOARDING_PREFILL_INVALID 로 거부됩니다(오타를 바로 알 수 있게 조용히 버리지 않습니다). pg_alias 를 보내면 allowed_pgs 의 PG 와 같아야 합니다.

1-2. 코드 예제

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/session`, {
    method: 'POST',
    headers: {
        'Authorization': RESELLER_AUTH,
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        kind: 'pg_join',
        allowed_pgs: ['nicepay'],
        prefill: { company_name: '예시상점', regist_no: '1234567890' },
        locked: ['company_name', 'regist_no'],
        return_url: 'https://reseller.example.com/onboarding/done',
        brand: { name: '예시 리셀러', logo_url: 'https://reseller.example.com/logo.png' }
    })
})
const { token, url, expires_at } = await res.json()
// token 만 판매자 화면에 넘긴다 — 로그에 남기지 않는다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.post(
    f'https://api.bootpay.co.kr/v2/reseller/seller/{provider_id}/onboarding/session',
    headers={'Authorization': auth},
    json={
        'kind': 'pg_join',
        'allowed_pgs': ['nicepay'],
        'prefill': {'company_name': '예시상점', 'regist_no': '1234567890'},
        'locked': ['company_name', 'regist_no'],
        'return_url': 'https://reseller.example.com/onboarding/done'
    }
)
session = res.json()  # token 은 판매자 화면에만 넘긴다python

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

curl -X POST "https://api.bootpay.co.kr/v2/reseller/seller/$PROVIDER_ID/onboarding/session" \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{"kind":"pg_join","allowed_pgs":["nicepay"]}'bash

1-3. 응답

{
  "token":      "rst_example_token",
  "url":        "https://admin.bootpay.co.kr/onboarding/s/rst_example_token",
  "expires_at": "2026-10-27T15:30:00+09:00"
}json

응답 파라미터

1-4. 판매자가 열었을 때

1-5. 에러 코드

2등록 폼 열기 (JS SDK)

리셀러 서버가 등록 폼 세션 발급 으로 받은 token 을 판매자 화면에 넘기고, Bootpay.requestOnboarding({ token }) 으로 부트페이 PG 가맹 신청 화면을 엽니다. 판매자가 접수하면 Promise 가 done 으로 끝납니다.

동작 규칙

• 결제창과 같은 JS SDK(@bootpay/client-js)의 함수입니다. 웹 브라우저에서만 열립니다.
• 여는 방식(display)은 iframe(기본, 지금 페이지 위 덮개) · popup(새 창) · redirect(지금 창 이동) 셋입니다.
• 접수하면 resolve {event: 'done', id, kind, pg_wait_id, status}, 판매자가 닫거나 「나중에 할게요」를 누르면 reject {event: 'cancel'}입니다.
• 화면 결과는 표시용입니다. 최종 상태는 리셀러 서버가 리셀러 웹훅 이나 등록 상태 조회 로 확인합니다.
• 토큰은 리셀러 서버에서 발급합니다. 리셀러 키를 브라우저에 두지 않습니다.

2-1. 함수

Bootpay.requestOnboarding(data: {
    token:    string                              // 등록 폼 토큰(rst_…) — 필수
    display?: 'iframe' | 'popup' | 'redirect'      // 기본 iframe
    url?:     string                              // 세션 발급 응답의 url 을 그대로 쓸 때만(부트페이 신청 화면 주소만 받는다)
}): Promise<{
    event:       'done' | 'cancel' | 'error'
    id?:         string        // 신청서 식별자(= onboarding_id)
    kind?:       string        // 'pg_join'
    pg_wait_id?: string        // id 와 같은 값
    status?:     number | null // 접수 직후 신청 상태
    error_code?: string
    message?:    string
}>typescript

2-2. 코드 예제

import { Bootpay } from '@bootpay/client-js'

// 리셀러 서버가 등록 폼 세션 발급 API 로 받은 token 만 화면에 넘긴다
const { token } = await fetch('/api/seller/onboarding-session', { method: 'POST' }).then((r) => r.json())

try {
    const result = await Bootpay.requestOnboarding({ token, display: 'iframe' })
    // result.event === 'done'
    showMessage('PG 신청을 접수했어요. 심사 진행은 알림으로 알려 드릴게요.')
    console.log(result.pg_wait_id, result.status)
} catch (e) {
    if (e.event === 'cancel') {
        // 판매자가 닫았다 — 나중에 다시 열 수 있게 둔다
    } else {
        console.error(e.error_code, e.message)
    }
}javascript

2-3. 여는 방식

redirect 로 돌아올 때

세션을 발급할 때 return_url 을 넣으면, 접수 뒤 그 주소에 결과 쿼리를 붙여 돌려보냅니다. 토큰은 쿼리에 넣지 않습니다.

https://reseller.example.com/onboarding/done?event=done&id=6718a0aa8f1b5b00367a0101&kind=pg_join&pg_wait_id=6718a0aa8f1b5b00367a0101&status=0
https://reseller.example.com/onboarding/done?event=cancel

쿼리 값은 누구나 바꿔 붙일 수 있습니다. 화면 안내에만 쓰고, 상태는 서버에서 등록 상태 조회 로 다시 확인합니다.

앱(웹뷰)에서 열 때

앱용 SDK 에는 아직 이 함수가 없습니다. 세션 발급 응답의 url 을 웹뷰나 외부 브라우저로 열고, return_url 을 앱이 받을 수 있는 https 주소로 넣어 돌아오는 시점을 잡습니다.

2-4. 신청 화면이 열리지 않을 때

2-5. 에러 코드

3등록 상태 조회

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

동작 규칙

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

API 정보

3-1. 요청 파라미터

3-2. 코드 예제

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

3-3. 응답

{
  "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

응답 파라미터

3-4. 단계 표

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

3-5. 에러 코드

4등록 API 접수

리셀러가 자기 화면에서 판매자의 사업자 정보·서류·약관 동의를 받아, 리셀러 서버가 하위 가맹점의 PG 가맹 신청서를 직접 냅니다. 부트페이 신청 화면을 띄우지 않는 길입니다. 부트페이 화면으로 받고 싶다면 등록 폼 세션 발급 을 사용합니다.

동작 규칙

• 순서는 약관 조회 → (서류가 있으면) 업로드 허가 받기 → storage 에 서류 올리기 → 신청서 접수​​입니다. 진행 상태는 등록 상태 조회 로 읽습니다.
• 신청서와 약관 동의 기록은 한 번에 저장​​됩니다. 동의가 빠지거나 버전이 다르면 신청서도 남지 않습니다.
• 약관 동의는 리셀러 화면에서 받으므로, 약관마다 동의 시각·동의한 사람의 IP·동의자​​를 함께 보냅니다. 이 값이 그대로 동의 기록이 됩니다.
• 접수 응답은 등록 상태 조회의 한 항목과 같은 모양입니다(channel 은 api).
• 지금 낼 수 있는 신청은 PG 가맹 신청(pg_join) 하나입니다. A형(대표가맹점) 리셀러는 아직 쓸 수 없습니다.

4-1. 전체 흐름

4-2. 약관 조회

판매자에게 보여 줄 약관의 현재 버전과 원문을 읽습니다. 접수 때 agreements[] 에는 여기서 받은 code·version 을 그대로 넣습니다. 약관이 바뀌면 이전 버전으로 낸 접수는 거부됩니다.

[
  {
    "code":         "pg_terms",
    "version":      2,
    "title":        "PG 서비스 이용약관",
    "body":         "(약관 원문)",
    "effective_at": "2026-10-01T00:00:00+09:00",
    "hash":         "sha256:example_hash",
    "required":     true
  }
]json

4-3. 서류 업로드 허가

사업자등록증을 올릴 수 있는 10분짜리 허가를 받습니다. 파일은 부트페이 API 서버를 거치지 않고 리셀러 서버가 upload_url 로 직접 올립니다.

{
  "grant":      "eyJ2IjoxLCJwX2lkIjoi...example.0f1e2d3c...",
  "upload_url": "https://s.bootapi.com/api/v1/secure_documents",
  "expires_at": "2026-10-27T15:10:00+09:00"
}json

받은 grant 를 X-Upload-Grant 헤더에 넣고, upload_url 로 multipart 업로드합니다. 파일은 PDF·JPG·PNG, 10MB 이하입니다.

storage 응답의 file_id 를 접수의 file_ids[] 에 넣습니다. 접수할 때 부트페이가 그 파일이 이 하위 가맹점이 올린 사업자등록증인지 확인하고, 파일 이름·형식·크기는 저장된 값으로 신청서에 남깁니다. 다른 가맹점이 올린 파일 id 는 받지 않습니다. 나머지 값(file_name·ext·mime_type·size)은 business_license 로 함께 보내도 되지만 저장된 값이 우선합니다.

{
  "file_id":   "6718a0aa8f1b5b00367a0201",
  "file_name": "사업자등록증.pdf",
  "ext":       "pdf",
  "mime_type": "application/pdf",
  "size":      182044
}json

허가 하나로 여러 번 올릴 수 있지만 10분이 지나면 다시 받습니다. 하위 가맹점의 커머스 연동이 아직 없으면 storage 가 STORAGE_SECURE_DOC_GRANT_OWNER_NOT_FOUND(3037)로 거부합니다 — 커머스 연동 재시도 뒤 다시 올립니다.

4-4. 신청서 접수

라이트페이(lightpay)는 희망 MID(expect_mid, 영문·숫자 10자 이내)와 정산 계좌(bank_code·account_number·account_owner)가 필수이고, 법인이면 대표자 생년월일(owner_birth_date, YYYYMMDD)·자본금(corp_capital)도 필수입니다. 글자 칸에는 문자열이나 숫자만 보냅니다.

동의 항목 (agreements[] 한 개)

코드 예제

import fetch from 'node-fetch'
import fs from 'node:fs'

const RESELLER_AUTH = 'Basic ' + Buffer
  .from(`${process.env.BOOTPAY_RESELLER_CLIENT_KEY}:${process.env.BOOTPAY_RESELLER_SECRET_KEY}`)
  .toString('base64')
const API = 'https://api.bootpay.co.kr/v2/reseller'
const providerId = '65a1c0aa8f1b5b00367a0001'

// 1. 지금 동의받을 약관
const terms = await (await fetch(`${API}/agreements`, { headers: { Authorization: RESELLER_AUTH } })).json()

// 2·3. 업로드 허가 → storage 에 직접 올리기
const grant = await (await fetch(`${API}/seller/${providerId}/files/grant`, {
    method: 'POST',
    headers: { Authorization: RESELLER_AUTH, 'Content-Type': 'application/json' },
    body: JSON.stringify({ kind: 'business_license' })
})).json()
const form = new FormData()
form.append('doc_type', 'business_license')
form.append('file', new Blob([fs.readFileSync('./license.pdf')], { type: 'application/pdf' }), 'license.pdf')
const file = await (await fetch(grant.upload_url, {
    method: 'POST',
    headers: { 'X-Upload-Grant': grant.grant },
    body: form
})).json()

// 4. 접수 — 판매자가 리셀러 화면에서 동의한 시각·IP 를 그대로 보낸다
const consent = { agreed_at: '2026-10-27T10:15:00+09:00', ip: '198.51.100.7', signer: { name: '김대표', phone: '01011112222' } }
const submitKey = crypto.randomUUID() // 이 접수를 다시 보낼 때도 같은 값을 쓴다
const res = await fetch(`${API}/seller/${providerId}/onboarding`, {
    method: 'POST',
    headers: { Authorization: RESELLER_AUTH, 'Content-Type': 'application/json', 'Idempotency-Key': submitKey },
    body: JSON.stringify({
        pg_alias: 'nicepay',
        company_name: '예시상점', seller_type: 4, regist_no: '1234567890', corp_reg_no: '1101111234567',
        owner_name: '김대표', business_type: '서비스', business_item: '소프트웨어',
        biz_email: 'biz@example.com', biz_tel: '0212345678', site_url: 'https://shop.example.com',
        name: '이담당', email: 'manager@example.com', phone: '01033334444',
        file_ids: [file.file_id],
        business_license: { file_name: file.file_name, ext: file.ext, mime_type: file.mime_type, size: file.size },
        agreements: terms.map((t) => ({ code: t.code, version: t.version, ...consent }))
    })
})
const onboarding = await res.json() // { pg_wait_id, status, stage, due_at, ... }javascript

import base64, os, requests

auth = 'Basic ' + base64.b64encode(
    f"{os.environ['BOOTPAY_RESELLER_CLIENT_KEY']}:{os.environ['BOOTPAY_RESELLER_SECRET_KEY']}".encode()
).decode()
api = 'https://api.bootpay.co.kr/v2/reseller'
provider_id = '65a1c0aa8f1b5b00367a0001'

terms = requests.get(f'{api}/agreements', headers={'Authorization': auth}).json()
grant = requests.post(f'{api}/seller/{provider_id}/files/grant', headers={'Authorization': auth},
                      json={'kind': 'business_license'}).json()
with open('license.pdf', 'rb') as f:
    file = requests.post(grant['upload_url'], headers={'X-Upload-Grant': grant['grant']},
                         data={'doc_type': 'business_license'},
                         files={'file': ('license.pdf', f, 'application/pdf')}).json()

consent = {'agreed_at': '2026-10-27T10:15:00+09:00', 'ip': '198.51.100.7'}
res = requests.post(f'{api}/seller/{provider_id}/onboarding', headers={'Authorization': auth}, json={
    'pg_alias': 'nicepay',
    'company_name': '예시상점', 'seller_type': 4, 'regist_no': '1234567890', 'corp_reg_no': '1101111234567',
    'owner_name': '김대표', 'business_type': '서비스', 'business_item': '소프트웨어',
    'biz_email': 'biz@example.com', 'biz_tel': '0212345678', 'site_url': 'https://shop.example.com',
    'name': '이담당', 'email': 'manager@example.com', 'phone': '01033334444',
    'file_ids': [file['file_id']],
    'agreements': [{'code': t['code'], 'version': t['version'], **consent} for t in terms]
})
onboarding = res.json()python

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

# 2. 업로드 허가
curl -X POST "https://api.bootpay.co.kr/v2/reseller/seller/$PROVIDER_ID/files/grant" \
  -H "Authorization: Basic $RESELLER_AUTH" -H 'Content-Type: application/json' \
  -d '{"kind":"business_license"}'

# 3. storage 에 올리기 — 위 응답의 grant·upload_url
curl -X POST "$UPLOAD_URL" -H "X-Upload-Grant: $UPLOAD_GRANT" \
  -F doc_type=business_license -F file=@license.pdf

# 4. 접수
curl -X POST "https://api.bootpay.co.kr/v2/reseller/seller/$PROVIDER_ID/onboarding" \
  -H "Authorization: Basic $RESELLER_AUTH" -H 'Content-Type: application/json' \
  -d @onboarding.jsonbash

응답

접수·보완 응답은 등록 상태 조회 목록의 한 항목과 같습니다.

{
  "provider_id":        "65a1c0aa8f1b5b00367a0001",
  "onboarding_id":      "6718a0aa8f1b5b00367a0101",
  "kind":               "pg_join",
  "status":             0,
  "status_name":        "미확인",
  "stage":              "intake",
  "stage_owner":        "ours",
  "due_at":             "2026-10-28T10:20:00+09:00",
  "reject_reason":      null,
  "pg_wait_id":         "6718a0aa8f1b5b00367a0101",
  "pg":                 "nicepay",
  "overdue":            false,
  "required_documents": [],
  "channel":            "api",
  "c_at":               "2026-10-27T10:20:00+09:00",
  "u_at":               "2026-10-27T10:20:00+09:00"
}json

4-5. 보완·재제출

서류 보완 요청을 받았거나 내용을 고칠 때 같은 신청서를 다시 냅니다. 판매자가 부트페이 콘솔이나 등록 폼으로 낸 그 가맹점의 신청서도 고칠 수 있습니다.

신청이 끝난(status 6) 신청서는 고칠 수 없습니다. 새로 신청하려면 3. 신청서 접수로 다시 냅니다. 응답은 접수와 같습니다.

4-6. 에러 코드

5신청서 서류 열기

하위 가맹점의 PG 가맹 신청서에 올라간 서류 목록과, 서류마다 3분 동안만 열 수 있는 열람 주소를 돌려줍니다. 신청서 id 는 등록 상태 조회 의 onboarding_id입니다.

동작 규칙

• 지금 신청서에 붙는 서류는 사업자등록증 하나입니다. 올리지 않았으면 list 가 빈 배열입니다.
• url 은 3분 뒤 막힙니다. 저장해 두지 말고 열 때마다 이 API 를 다시 부릅니다.
• 서류는 개인정보입니다. url 을 로그·에러 리포팅·브라우저 주소 공유에 남기지 않습니다.
• 부를 때마다 열람 기록이 신청서에 남습니다(리셀러가 열었다는 기록).
• 판매자가 콘솔에서 직접 낸 신청서도 본인 하위 가맹점 것이면 열 수 있습니다.
• 다른 가맹점이나 다른 리셀러 하위의 신청서는 없는 것과 같은 PG_WAIT_NOT_FOUND입니다.
• 열기 전에 서류가 그 하위 가맹점이 올린 파일인지 확인합니다. 아니거나 지워진 파일이면 그 서류는 list 에 나오지 않습니다.

API 정보

5-1. 요청 파라미터

5-2. 코드 예제

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 onboardingId = '65a1c0aa8f1b5b00367a0050'

const res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/${providerId}/onboarding/${onboardingId}/documents`, {
    headers: { 'Authorization': RESELLER_AUTH }
})
const { list } = await res.json()
// list[0].url 을 바로 열어 보여 준다 — 저장하지 않는다javascript

import base64, os, requests

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

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

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

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

5-3. 응답

{
  "onboarding_id": "65a1c0aa8f1b5b00367a0050",
  "list": [
    {
      "kind":        "business_license",
      "file_name":   "사업자등록증.pdf",
      "mime_type":   "application/pdf",
      "size":        482113,
      "uploaded_at": "2026-10-20T11:02:00+09:00",
      "url":         "https://s.bootapi.com/api/v1/secure_documents/example_file_id/download?expires=1793090063&p=65a1c0aa8f1b5b00367a0001&sig=example_signature",
      "expires_at":  "2026-10-27T10:03:00+09:00",
      "expires_in":  180
    }
  ]
}json

5-4. 에러 코드