Paiements
Capturer
POST/v1/payment-intents/{id}/capturepayments:write
Requires payments:write, recent MFA for cookie sessions, CSRF and a stable Idempotency-Key. An AUTHORIZED payment and manual capture capability are required. Partial capture additionally requires partial_capture. The remainder is released; multiple captures are unsupported. HTTP 202 only acknowledges the durable command. Retry the same key and amount after a lost response.
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
Paramètres
iddans le cheminobligatoire
Corps
amountstringobligatoire
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.