홈 주문 조회 블로그 문의하기 개발자센터

Cancel API

취소 API

외부 고객사는 주문 취소 전에 수수료를 조회하고, 같은 주문에 대해 idempotent 하게 취소를 실행해야 합니다. 취소 수수료는 실행 시점에 다시 검증됩니다.

제공 엔드포인트

POST /api/v1/orders/{orderId}/cancel-fee — 취소 수수료 조회
POST /api/v1/orders/{orderId}/cancel — 취소 실행

핵심 제약

취소 실행에는 Idempotency-Key 헤더가 필요합니다.
expectedFee 와 실제 계산 수수료가 다르면 cancel_fee_changed 를 반환합니다.
배차 취소 성공 후 등록 카드의 원 결제를 전액 또는 부분 취소합니다.
응답 상태는 cancelled, cancel_partial, cancel_failed 를 지원합니다.

취소 수수료 조회

HTTP

POST /api/v1/orders/{orderId}/cancel-fee

취소 실행 요청 예시

JSON 요청

{
  "expectedFee": 0,
  "cancelReason": "customer request"
}