API de paiement de commande d’approvisionnement
POST /v1/orders/pay
Corps de requête
| Champ | Obligatoire | Description |
|---|---|---|
channel | Oui | 1688 | taobao |
order_id | Oui | ID de commande principal depuis création |
pay_channel | 1688 optionnel | par ex. Alipay / kjpayV2 |
Réponse
StandardOrderPayResult — modèle de réponse.
Confirmation et reprise du paiement {#recovery-guidance}
Taobao self standard renvoie success: true seulement après confirmation par la commande. code: "0" ou un ancien succès ne prouve pas le débit. pending est un état non confirmé du Gateway, pas une file officielle.
Idempotency-Key est un en-tête HTTP facultatif. Réutiliser la même clé pour une tentative ; une nouvelle clé soumet un nouveau paiement réel, jamais automatiquement pour contourner un résultat incertain.
Nouveaux champs facultatifs:
payment_submission_status:submitted/rejected/unknown.payment_recovery:action,reason,elapsed_seconds.
| action | Confirmation et reprise du paiement |
|---|---|
none | Ne plus payer |
query_order | Consulter la commande ou réutiliser la clé |
retry_with_new_key | Après refus explicite, corriger la cause et vérifier la commande payable avant une nouvelle tentative |
manual_review | Vérifier manuellement les paiements et mouvements du compte ; jamais réessayer automatiquement |
Après 15 minutes depuis la tentative initiale avec clé : unknown / manual_review / CONFIRMATION_OVERDUE. Ce seuil ne prouve ni échec ni expiration ; il ne libère pas la clé et ne relance pas le paiement. Les reprises anciennes, expirées ou bloquées consultent seulement la commande et enregistrent la confirmation. Avant une nouvelle clé, confirmer manuellement que la tentative précédente est terminée sans paiement ni débit. Un statut impayé seul ne suffit pas.
Le corps request_id identifie la tentative initiale ; l’en-tête x-request-id, la requête HTTP actuelle. Upstream, sandbox et entrepôt restent inchangés. 1688 fournit ces conseils pour un paySuccess explicite ; renouveler aussi un op_request_id explicite lors d’une nouvelle tentative.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days