調達注文支払い 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