결제 완료 화면에 표시할 주문번호·금액·상품·영수증 등 주문·구독 결과를 조회합니다. 운영·정산용 전체 데이터는 주문 상세로 조회합니다.
구매자 화면에서 본인 주문의 결제·배송 상태를 확인할 때는 구매자 결제 결과 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_ |
주문을 찾을 수 없습니다 | 주문 고유번호(order_number)가 맞는지 확인합니다 |
ORDER_ |
주문 결제 결과 페이지 조회가 불가능한 진행상태입니다. 다시 시도해주세요. | 결제가 끝나지 않은(결제 대기) 주문인지 확인합니다 |
ORDER_ |
구독결제의 경우 로그인이 필요합니다. 로그인 후 다시 시도해주세요. | JWT 또는 secretKey 인증의 user_id를 보냅니다 |



