구매 주문 결제 API
POST /v1/orders/pay
요청 본문
| 필드 | 필수 | 설명 |
|---|---|---|
channel | 예 | 1688 | taobao |
order_id | 예 | create에서 받은 기본 주문 id |
pay_channel | 1688 선택 | 예: Alipay / kjpayV2 |
응답
StandardOrderPayResult — response model.
결제 확인 및 복구 {#recovery-guidance}
Taobao self 표준 모드는 주문 조회로 결제를 확인한 경우에만 success: true를 반환합니다. code: "0" 또는 기존 성공 응답은 출금 증거가 아닙니다. pending은 Gateway의 미확인 상태이지 공식 대기열 상태가 아닙니다.
Idempotency-Key는 선택적 HTTP 헤더입니다. 같은 시도에는 같은 Key를 사용하세요. 새 Key는 새로운 실제 결제를 제출하므로 미확인 결과를 우회하려고 자동 생성하면 안 됩니다.
새 선택 필드:
payment_submission_status:submitted/rejected/unknown.payment_recovery:action,reason,elapsed_seconds.
| action | 결제 확인 및 복구 |
|---|---|
none | 다시 결제하지 않음 |
query_order | 주문 조회 또는 같은 Key 재사용 |
retry_with_new_key | 명시적 거절 원인을 해결하고 주문이 결제 가능한지 확인한 뒤 새 시도 |
manual_review | 결제 기록과 계좌 거래를 수동 확인; 자동 재결제 금지 |
원래 Key를 사용한 시도로부터 15분 후에도 미확인이면 unknown / manual_review / CONFIRMATION_OVERDUE입니다. 공식 실패나 만료 증거가 아니며 Key 해제나 재출금도 없습니다. 기존 결과, 타임아웃, 정체된 시도는 조회만 하고 확인을 저장합니다. 새 Key 전에 이전 시도가 결제·출금 없이 종료됐는지 수동 확인해야 합니다. 미결제 주문 표시만으로는 부족합니다.
본문 request_id는 원래 시도, 헤더 x-request-id는 현재 HTTP 요청입니다. upstream, sandbox, 창고 모드는 유지됩니다. 1688은 명시적인 paySuccess에 안내를 추가합니다. 새 시도에 명시한 op_request_id도 새 값이어야 합니다.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days