Mettre à jour un paiement
https://api.mobupay.nc/api/v1/payments/{id}Ce que fait cet appel
Met à jour un paiement. Les métadonnées (metadata) sont toujours modifiables. L'objet order (mêmes champs qu'à la capture : platformConfig, amount, discount, items, taxDetail, tips, et le contexte reference, delivery, buyer, device, invoicing ; currency et taxAmount refusés) n'est modifiable que tant que le paiement n'est PAS capturé (statut authorized / pending), et ne peut pas augmenter le prix au-delà du montant autorisé (order.amount − order.discount ≤ montant autorisé). Couplé à une capture simple (POST /payments/{id}/capture sans corps), cela permet de définir l'order à la capture en 2 étapes : 1 mise à jour puis 1 capture.
Verrou de session : un paiement pending dont la page de paiement (session widget) est déjà ouverte est verrouillé (409 PAYMENT_SESSION_LOCKED) : le montant présenté au client est figé par le widget, modifier l'order créerait un écart entre le montant réellement débité et le montant enregistré. Pour changer le montant, créez une nouvelle session de paiement.
Authorization: Bearer sk_test_XXXXLe pool est déduit du préfixe de la clé
Il n'y a pas d'interrupteur test et production sur cette page. sk_test_* ne traite aucun paiement réel, sk_live_* encaisse.
Paramètres
1 en-têteidstringRequispathIdentifiant du paiement (`pay_*`).
Corps de la requête
application/jsonmetadataobjectOptionnelMétadonnées libres (toujours modifiables, même après capture). Fusionnées avec les métadonnées existantes.
Objet `order` à mettre à jour (uniquement si le paiement n'est pas capturé). Tous les champs sont optionnels.
Codes de retour
Paiement mis à jour.
Champ interdit, incohérence platformConfig/amount, ou hausse de prix (AMOUNT_EXCEEDS_AUTHORIZATION).
Paiement introuvable.
Paiement déjà capturé (PAYMENT_ALREADY_CAPTURED), ou paiement pending avec session widget ouverte (PAYMENT_SESSION_LOCKED : montant carte figé, créer une nouvelle session pour modifier l'order).
Langage
Cliquez sur Essayer pour lancer la requête et voir la réponse ici.