팀·프로젝트 초대

리셀러가 셀러의 부트페이 콘솔 권한을 코드로 발급한다. 셀러 전체(provider) 에 접근시키거나, 특정 프로젝트(app) 에만 권한을 묶는 두 가지 모드가 있다. 메일이 발송되고, 수신자가 메일 안의 링크로 초대를 승인해야 권한이 부여된다.

핵심 요약

• invite_type 으로 팀(provider) / 프로젝트(app) 두 종류를 구분한다.
• 호출 시점에 권한이 바로 붙지는 않는다. 승인 대기(READY) 상태의 초대가 만들어지고 메일이 발송될 뿐이다. 수신자가 링크로 승인해야 실제 권한이 생긴다.
• 초대 링크는 생성 시점부터 24시간 뒤 만료된다. 만료되면 다시 초대해야 한다.
• 미승인 초대가 같은 이메일·가맹점 조합으로 10건을 넘고, 그중 11번째로 최근인 초대가 만들어진 지 1일이 지났으면 INVITE_LIMIT_OVER 로 막힌다. 시간이 지나도 자동으로 풀리지 않는다.
• 응답 본문은 비어 있다. HTTP 200 이면 초대가 생성되고 메일이 발송된 상태다.

두 가지 초대 모드

API 정보

요청 파라미터

권한 레벨

level 은 invite_type 에 따라 의미가 달라진다.

invite_type=app (프로젝트 권한)

invite_type=provider (팀 권한)

코드 예제

셀러 전체 권한 부여

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 res = await fetch('https://api.bootpay.co.kr/v2/reseller/invite', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': RESELLER_AUTH
    },
    body: JSON.stringify({
        invite_type: 'provider',
        provider_id: '65a1c0aa8f1b5b00367a0001',
        email:       'owner@hanip.shop',
        level:       'admin'
    })
})
console.log(res.status) // 200javascript

import base64, os, requests

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

payload = {
    'invite_type': 'provider',
    'provider_id': '65a1c0aa8f1b5b00367a0001',
    'email':       'owner@hanip.shop',
    'level':       'admin'
}
res = requests.post(
    'https://api.bootpay.co.kr/v2/reseller/invite',
    json=payload,
    headers={'Authorization': auth}
)
print(res.status_code)python

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

curl -X POST 'https://api.bootpay.co.kr/v2/reseller/invite' \
  -H "Authorization: Basic $RESELLER_AUTH" \
  -H 'Content-Type: application/json' \
  -d '{
    "invite_type": "provider",
    "provider_id": "65a1c0aa8f1b5b00367a0001",
    "email":       "owner@hanip.shop",
    "level":       "admin"
  }'bash

특정 프로젝트만 권한 부여

const res = await fetch('https://api.bootpay.co.kr/v2/reseller/invite', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': RESELLER_AUTH
    },
    body: JSON.stringify({
        invite_type: 'app',
        app_id:      '65a1c0ab8f1b5b00367a0010',
        email:       'cs@hanip.shop',
        level:       'member'   // CS 담당자는 조회 권한만
    })
})javascript

응답

성공 시 응답 본문은 비어 있고, HTTP 200 으로 떨어진다. 초대 메일은 응답 직후 비동기로 발송된다.

동작 규칙

가입 여부와 관계없이 동작은 같다. 승인 대기(READY) 상태의 초대가 만들어지고 메일이 나간다. 권한은 수신자가 링크로 승인한 뒤에 부여된다.

에러 코드

다음 단계

• 추가 프로젝트를 만들고 초대를 이어가려면 → 프로젝트 생성
• 결제수단을 갱신하면서 운영을 본격화하려면 → PG 리소스 갱신