배송이 완료된 주문을 구매확정 처리해요. 확정된 주문은 취소·반품 흐름에서 빠지고 정산 대상이 돼요.
API 엔드포인트
POST
https://api.bootapi.com/v1/order/confirmBasic Auth되돌릴 수 없어요
구매확정은 되돌리는 API가 없어요. 확정 후에는 일반적인 취소 요청이 제한되니, 배송 완료가 확인된 주문에만 호출해요.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
order_number |
String | 필수 | 주문번호 |
order_id 가 아니라 order_number 예요
주문 목록 응답의 order_number(예: 25071182085082524116)를 넣어요. order_id를 넣으면 주문을 찾지 못해요.
코드 예제
curl -X POST "https://api.bootapi.com/v1/order/confirm" \
-H "Authorization: Basic {base64(client_key:secret_key)}" \
-H "Content-Type: application/json" \
-d '{
"order_number": "25071182085082524116"
}'bashrequire 'bootpay-backend-ruby'
commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.order_confirm(order_number: '25071182085082524116')
puts responseruby응답
{
"order_number": "25071182085082524116",
"status": 20,
"confirmed_at": "2025-08-01T12:00:00Z"
}json응답 파라미터
| 파라미터 | 타입 | 설명 |
|---|---|---|
| order_number | String | 주문번호 |
| status | Integer | 확정 후 주문 상태 |
| confirmed_at | String | 구매확정 시각 |
에러 코드
공통 에러
인증·권한 관련 에러는 에러 코드표를 참고해요.
| 코드 | 메시지 | 대처 방법 |
|---|---|---|
ORDER_NOT_FOUND |
주문을 찾을 수 없어요. | order_number가 맞는지 확인해요 |