결제 결과 조회

결제 완료 화면에 표시할 주문번호·금액·상품·영수증 등 주문·구독 결과를 조회합니다. 운영·정산용 전체 데이터는 주문 상세로 조회합니다.

구매자 화면에서 본인 주문의 결제·배송 상태를 확인할 때는 구매자 결제 결과 API인 GET /v1/orders/:order_number/result를 사용합니다. 회원은 Bootpay-User-JWT 또는 secretKey 인증의 user_id, 비회원은 결제 준비에서 받은 Bootpay-Order-Result-Token과 같은 Bootpay-Device-UUID로 소유권을 확인합니다.

이 값으로 주문을 확정하지 않습니다

결과 조회는 화면을 그리기 위한 것입니다. 주문 상태를 바꾸는 판단은 주문 상세로 금액·상태를 대조하고 웹훅으로 한 번 더 확인한 뒤에 합니다.


주문 결과

GEThttps://api.bootapi.com/v1/order/result/:order_numberBasic Auth
파라미터 타입 필수 설명
: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를 확인합니다.


구독 결과

GEThttps://api.bootapi.com/v1/order/result/subscription?oid=:order_numberBasic Auth

구독 신청 결제가 끝난 직후에 씁니다. 주문 결과에 구독 계약 정보​​가 함께 실립니다.

구독 결과에는 회원 지정이 필요합니다

서버 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
파라미터 이름이 `oid` 입니다

다른 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를 보냅니다

함께 보기