주문 상세가 운영·정산용 전체 데이터라면, 이쪽은 결과 화면 한 장에 필요한 만큼만 담겨 있어요. 결제 완료 페이지에서 주문번호·금액·상품·영수증을 보여줄 때 써요.
구매자 화면에서 본인 주문의 결제·배송 상태를 확인할 때는 구매자 결제 결과 API인 GET /v1/orders/:order_number/result를 사용해요. 회원은 Bootpay-User-JWT 또는 secretKey 인증의 user_id, 비회원은 결제 준비에서 받은 Bootpay-Order-Result-Token과 같은 Bootpay-Device-UUID로 소유권을 확인해요.
주문 결과
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
:order_number (경로) |
String | 필수 | 주문 고유번호. 리다이렉트 쿼리로 돌아온 값을 그대로 넣어요 |
curl -X GET "https://api.bootapi.com/v1/order/result/25071182085082524116" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bash응답에는 주문번호·주문명·금액·상태·상품 목록과 결제 결과(result_data)가 담겨요. 다만 평문 JSON 이 아니라 주문 경로에 따라 두 모양으로 와요.
| 주문 | 응답 |
|---|---|
SDK 주문 — 커머스 SDK 주문서(requestCheckout), 주문 준비의 response_type: "url" |
{ "payload": {주문 필드}, "extra": {...}, "sdk": true, "use_redirect": ..., "redirect_url": "..." } — payload 필드 의미는 주문 상세와 같아요 |
| 그 밖의 주문 — 쇼핑몰 주문, 주문 준비 기본 응답 | 암호화된 문자열 하나(JSON 문자열). 쇼핑몰 화면용이라 서버에서 풀어 쓰는 값이 아니에요 |
이 API는 인증한 프로젝트의 주문만 조회해요. Bootpay-User-JWT 또는 user_id를 지정하면 그 회원 주문만 조회하고, 지정하지 않으면 서버가 같은 프로젝트의 주문을 조회해요. 서버에서 결제 금액과 상태를 검증할 때는 주문 상세를 써요. 전체 필드와 오류는 주문 처리 API를 확인해요.
구독 결과
구독 신청 결제가 끝난 직후에 써요. 주문 결과에 구독 계약 정보가 함께 실려요.
서버 Basic 인증에 더해 Bootpay-User-JWT 또는 secretKey 인증의 user_id로 주문 소유 회원을 지정해요. 회원을 지정하지 않으면 ORDER_SUBSCRIBE_NEED_LOGIN이에요. 지정한 회원의 주문이 아니면 ORDER_NOT_FOUND예요.
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
oid |
String | 필수 | 주문 고유번호. 경로가 아니라 질의 문자열이에요 |
curl -X GET "https://api.bootapi.com/v1/order/result/subscription?oid=25071182085082524116" \
-H "Authorization: Basic {base64(client_key:secret_key)}" \
-H "Bootpay-User-JWT: {customer_jwt}"bash다른 API 는 order_number 를 쓰는데 이 엔드포인트만 oid 로 받아요. order_number 로 보내면 주문을 찾지 못해요.
구독 상태 값은 구독 상태를 봐요.
에러 코드
인증·권한 관련 에러는 커머스 API 인증 에러를 참고해요.
| 코드 | 메시지 | 대처 방법 |
|---|---|---|
ORDER_NOT_FOUND |
주문을 찾을 수 없어요 | 주문 고유번호(order_number)가 맞는지 확인해요 |
ORDER_RESULT_LOOKUP_UNABLE_STATUS |
결과를 조회할 수 없는 주문 상태예요 | 결제가 끝나지 않은(결제 대기) 주문인지 확인해요 |
ORDER_SUBSCRIBE_NEED_LOGIN |
구독 주문은 회원 지정이 필요해요 | JWT 또는 secretKey 인증의 user_id를 보내요 |