DocsTableau de bord

Paiements

Capturer

POST/v1/payment-intents/{id}/capturepayments:write

Autorisation payments:write. et une Idempotency-Key. Capture un paiement AUTHORIZED créé avec capture_mode manual, une seule fois ; une capture partielle libère le reste, si le compte la permet. 202 veut dire « demande enregistrée ». Après une réponse perdue, renvoyez la même clé et le même montant.

En-têtes

AuthorizationBearer pos_key_…obligatoire
Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire
L’espace marchand concerné (mrc_…).
Idempotency-Keystringobligatoire
La même clé avec la même demande retrouve la première réponse ; avec une autre demande : 409.

Paramètres

iddans le cheminobligatoire

Corps

amountstringobligatoire
Le montant en texte, avec ses décimales (124.90). Les limites de chaque devise : GET /v1/currencies.

Réponses

202Demande enregistrée
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
404Ressource introuvable
409Conflit avec une demande existante
429Trop de demandes, réessayez plus tard
503Service momentanément indisponible

Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.