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