API оплаты заказа закупки
POST /v1/orders/pay
Request body
| Поле | Обязательно | Описание |
|---|---|---|
channel | Да | 1688 | taobao |
order_id | Да | Main order id из create |
pay_channel | 1688 optional | Например Alipay / kjpayV2 |
Ответ
StandardOrderPayResult — модель ответа.
Подтверждение и восстановление платежа {#recovery-guidance}
Taobao self standard возвращает success: true только после подтверждения запросом заказа. code: "0" или старый успех не доказывает списание. pending означает неподтверждённый результат Gateway, не официальную очередь.
Idempotency-Key — необязательный HTTP-заголовок. Для одной попытки использовать тот же ключ; новый ключ отправляет новый реальный платёж, не создавать его автоматически при неизвестном результате.
Новые необязательные поля:
payment_submission_status:submitted/rejected/unknown.payment_recovery:action,reason,elapsed_seconds.
| action | Подтверждение и восстановление платежа |
|---|---|
none | Не платить повторно |
query_order | Запросить заказ или использовать тот же ключ |
retry_with_new_key | После явного отказа устранить причину и проверить возможность оплаты перед новой попыткой |
manual_review | Вручную проверить платежи и движения средств; не списывать повторно автоматически |
После 15 минут от исходной попытки с ключом: unknown / manual_review / CONFIRMATION_OVERDUE. Порог не доказывает неудачу или истечение срока, не разблокирует ключ и не запускает платёж. Старые, просроченные и зависшие повторы только запрашивают заказ и сохраняют подтверждение. До нового ключа вручную подтвердить, что прошлый платёж завершён без оплаты или списания. Неоплаченного статуса недостаточно.
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