구독 주문 생성
빌링키를 사용하여 구독 주문을 생성하는 API입니다.
사용자의 결제 정보(빌링키)가 이미 등록된 상태에서, 서버에서 직접 구독 결제를 시작할 수 있습니다.
POST
https://api.bootapi.com/v1/orders/subscription
빌링키 필수
이 API를 사용하려면 사용자의 빌링키가 미리 등록되어 있어야 합니다. 빌링키는 카드 등록 과정에서 발급받을 수 있습니다.
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
구독 주문 생성 요청
구독 정보와 빌링키를 담아 API를 호출합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 필수 | 구독 주문명 |
user_id | string | 필수 | 사용자 ID |
products | array | 필수 | 상품 목록 (product_id, quantity 등) |
price | number | 필수 | 결제 금액 |
billing_key | string | 필수 | 빌링키 (자동결제용) |
metadata | object | 추가 메타데이터 |
3
Server
응답 처리
생성된 구독 주문 정보가 반환됩니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
order_id | string | 생성된 주문 ID |
order_subscription_id | string | 구독 계약 ID |
status | number | 주문 상태 |
에러 코드
USER_NOT_FOUND
사용자를 찾을 수 없습니다.
올바른 user_id를 입력하세요.
BILLING_KEY_NOT_FOUND
빌링키를 찾을 수 없습니다.
유효한 빌링키를 입력하세요.
PRODUCT_NOT_FOUND
상품을 찾을 수 없습니다.
올바른 product_id를 입력하세요.
