PG 리소스 갱신

프로젝트(app) 에 등록되어 있는 PG·결제수단·발급키를 갱신한다. 신규 결제수단을 추가하거나, PG 사가 발급한 가맹점 키가 바뀌었을 때 본사 콘솔에서 이 API 만 호출하면 셀러 콘솔을 건드릴 필요가 없다.

핵심 요약

• resources 배열에 포함된 결제수단은 추가 또는 갱신된다. 배열에 빠진 결제수단은 그대로 유지된다 — 전체 덮어쓰기가 아니다.
• 기존에 등록된 PG·결제수단 묶음에 같은 pg + method 조합이 들어오면 발급키만 갱신된다.
• sandbox: true 로 등록하면 테스트 모드 키로 분리된다. 운영 키로 교체할 때는 sandbox: false 또는 생략한다.
• 응답으로 프로젝트의 최신 정보(application_keys, payment_apps) 가 모두 다시 내려온다.

API 정보

요청 파라미터

resources 배열 형식

코드 예제

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 appId = '65a1c0ab8f1b5b00367a0010'

const res = await fetch(`https://api.bootpay.co.kr/v2/reseller/seller/app/resource/${appId}`, {
    method: 'PATCH',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': RESELLER_AUTH
    },
    body: JSON.stringify({
        resources: [
            {
                pg:     'nicepay',
                method: '카드',
                sandbox: false,
                resource: {
                    mid:          'nicepay00m',
                    merchant_key: 'EYzu8jGGMfqaDEp76gSckuvnaHHu+...='
                }
            },
            {
                pg:     'nicepay',
                method: '카드자동',
                sandbox: false,
                resource: {
                    mid:          'nicepay00m',
                    merchant_key: 'EYzu8jGGMfqaDEp76gSckuvnaHHu+...='
                }
            }
        ]
    })
})
const data = await res.json()
console.log(data)javascript

import base64, os, requests

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

app_id = '65a1c0ab8f1b5b00367a0010'

payload = {
    'resources': [
        {
            'pg':     'nicepay',
            'method': '카드',
            'sandbox': False,
            'resource': {
                'mid':          'nicepay00m',
                'merchant_key': 'EYzu8jGGMfqaDEp76gSckuvnaHHu+...='
            }
        },
        {
            'pg':     'nicepay',
            'method': '카드자동',
            'sandbox': False,
            'resource': {
                'mid':          'nicepay00m',
                'merchant_key': 'EYzu8jGGMfqaDEp76gSckuvnaHHu+...='
            }
        }
    ]
}

res = requests.patch(
    f'https://api.bootpay.co.kr/v2/reseller/seller/app/resource/{app_id}',
    json=payload,
    headers={'Authorization': auth}
)
print(res.json())python

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

curl -X PATCH "https://api.bootpay.co.kr/v2/reseller/seller/app/resource/$APP_ID" \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{
    "resources": [
      {
        "pg": "nicepay",
        "method": "카드",
        "sandbox": false,
        "resource": {
          "mid": "nicepay00m",
          "merchant_key": "EYzu8jGGMfqaDEp76gSckuvnaHHu+...="
        }
      },
      {
        "pg": "nicepay",
        "method": "카드자동",
        "sandbox": false,
        "resource": {
          "mid": "nicepay00m",
          "merchant_key": "EYzu8jGGMfqaDEp76gSckuvnaHHu+...="
        }
      }
    ]
  }'bash

응답

프로젝트의 최신 상태가 통째로 내려온다.

{
  "app_id":   "65a1c0ab8f1b5b00367a0010",
  "app_name": "한입가게 — 정기구독",
  "real":     { "name": "비실물", "value": 0, "desc": "" },
  "unit":     "KRW",
  "application_keys": [
    { "type": 1, "name": "WEB",     "key": "65a1c0ab8f1b5b00367a0011" },
    { "type": 2, "name": "Android", "key": "65a1c0ab8f1b5b00367a0012" },
    { "type": 3, "name": "iOS",     "key": "65a1c0ab8f1b5b00367a0013" },
    { "type": 4, "name": "REST",    "key": "65a1c0ab8f1b5b00367a0014" }
  ],
  "private_key": "kQ3f8vB2pN7sXq1wE5rT9yU0iO4aS6dF8gH2jK5lZ0c=",
  "payment_apps": [
    {
      "payment_resource_id": "65a1c0ab8f1b5b00367a0015",
      "pg_id":               "6098a1b2c3d4e5f600000101",
      "pg_name":             "나이스페이먼츠",
      "pg_alias":            "nicepay",
      "method_id":           "6098a1b2c3d4e5f600000201",
      "method_name":         "카드",
      "method_alias":        "card",
      "resource_mode":       1,
      "sandbox_mode":        false,
      "easypay":             false,
      "updated_at":          "2024-01-12T18:04:11+09:00",
      "status":              20,
      "resource": {
        "mid":          "nicepay00m",
        "merchant_key": "EYzu8jGGMfqaDEp76gSckuvnaHHu+..."
      }
    },
    {
      "payment_resource_id": "65a1c0ab8f1b5b00367a0016",
      "pg_id":               "6098a1b2c3d4e5f600000101",
      "pg_name":             "나이스페이먼츠",
      "pg_alias":            "nicepay",
      "method_id":           "6098a1b2c3d4e5f600000202",
      "method_name":         "카드자동",
      "method_alias":        "card_rebill",
      "resource_mode":       1,
      "sandbox_mode":        false,
      "easypay":             false,
      "updated_at":          "2024-01-12T18:04:11+09:00",
      "status":              20,
      "resource": {
        "mid":          "nicepay00m",
        "merchant_key": "EYzu8jGGMfqaDEp76gSckuvnaHHu+..."
      }
    }
  ],
  "status": 20
}json

응답 파라미터

동작 규칙

에러 코드

다음 단계

• 결제 연동키로 결제창을 띄우려면 → 결제창 연동
• 셀러 담당자를 콘솔에 초대하려면 → 팀·프로젝트 초대