구독 계약 ID로 단일 계약의 상세 정보를 조회해요. 계약 목록에서 얻은 order_subscription_id를 넣어요.
API 엔드포인트
GET
https://api.bootapi.com/v1/order_subscriptions/:order_subscription_idBasic Auth경로는 언더스코어예요
order_subscriptions 는 언더스코어를 써요. 하이픈을 쓰는 건 신청 관리의 order-subscription-requests 와 마켓플레이스의 user-groups 뿐이에요.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_subscription_id |
String | 필수 | 구독 계약 ID (URL 경로) |
코드 예제
curl -X GET "https://api.bootapi.com/v1/order_subscriptions/687a1b2c3d4e5f6789012345" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bashimport kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;
import kr.co.bootpay.store.model.response.BootpayStoreResponse;
TokenPayload tp = new TokenPayload("your-commerce-client-key", "your-commerce-secret-key");
BootpayStore commerce = new BootpayStore(tp).withToken();
BootpayStoreResponse response = commerce.orderSubscription.detail("687a1b2c3d4e5f6789012345");
System.out.println(response);javarequire 'bootpay-backend-ruby'
commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.order_subscription_detail(order_subscription_id: '687a1b2c3d4e5f6789012345')
puts responseruby응답
{
"order_subscription_id": "687a1b2c3d4e5f6789012345",
"order_name": "Professional 플랜 구독",
"status": 1,
"quantity": 2,
"total_subscription_duration": 12,
"service_start_at": "2025-08-01T00:00:00Z"
}json응답 파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
| order_subscription_id | String | 구독 계약 ID |
| order_name | String | 구독 상품명 |
| status | Integer | 구독 상태 |
| quantity | Integer | 수량 |
| total_subscription_duration | Integer | 총 회차 |
| service_start_at | String | 서비스 시작일 |
에러 코드
공통 에러
인증·권한 관련 에러는 에러 코드표를 참고해요.
| 코드 | 메시지 | 대처 방법 |
|---|---|---|
ORDER_SUBSCRIPTION_INVALID |
구독 계약을 찾을 수 없어요. | order_subscription_id를 확인해요 |