팀·프로젝트 초대

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

핵심 요약

• invite_type 으로 팀(provider) / 프로젝트(app) 두 종류를 구분한다.
• 같은 이메일을 짧은 시간에 반복 초대하면 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 으로 떨어진다. 초대 메일은 응답 직후 비동기로 발송된다.

동작 규칙

에러 코드

다음 단계

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