API para pagar pedido de compra
POST /v1/orders/pay
Cuerpo de la solicitud
| Campo | Obligatorio | Descripción |
|---|---|---|
channel | Sí | 1688 | taobao |
order_id | Sí | Id de pedido principal desde create |
pay_channel | 1688 opcional | Por ejemplo, Alipay / kjpayV2 |
Respuesta
StandardOrderPayResult: modelo de respuesta.
Confirmación y recuperación del pago {#recovery-guidance}
Taobao self estándar devuelve success: true solo tras confirmar el pago consultando el pedido. code: "0" o un éxito antiguo no prueban un cargo. pending significa no confirmado por el Gateway, no una cola oficial.
Idempotency-Key es una cabecera HTTP opcional. Reutilice la misma clave para un intento; una clave nueva envía un pago real nuevo, no debe generarse automáticamente ante un resultado incierto.
Campos nuevos opcionales:
payment_submission_status:submitted/rejected/unknown.payment_recovery:action,reason,elapsed_seconds.
| action | Confirmación y recuperación del pago |
|---|---|
none | No volver a pagar |
query_order | Consultar el pedido o reutilizar la clave |
retry_with_new_key | Tras rechazo explícito, corregir la causa y comprobar que el pedido sigue siendo pagable antes de otro intento |
manual_review | Revisar manualmente pagos y movimientos de cuenta; no reintentar automáticamente |
Tras 15 minutos desde el intento original con clave: unknown / manual_review / CONFIRMATION_OVERDUE. El umbral no prueba fallo ni caducidad; no desbloquea la clave ni vuelve a cobrar. Los reintentos antiguos, agotados o atascados solo consultan y guardan la confirmación. Antes de otra clave, confirmar manualmente que el intento anterior terminó sin pago ni cargo. Un pedido pendiente por sí solo no basta.
El cuerpo request_id identifica el intento original; la cabecera x-request-id, la petición HTTP actual. Upstream, sandbox y almacén no cambian. 1688 añade la guía para paySuccess explícito; renovar también un op_request_id explícito en otro intento.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days