Captures et annulations

Quand votre passerelle est configurée en mode authorize (réserver les fonds, capturer plus tard) au lieu de mode sale (capture immédiate), vous disposez de deux actions de suivi : capture ou void.

Capture

POST /api/v1/payments/{transaction_id}/capture

Capture une transaction préalablement autorisée. Après capture, les fonds sont versés au marchand. Déclenche payment.completed.

Void

POST /api/v1/payments/{transaction_id}/void

Libère la réservation d'autorisation. La carte du client est libérée du paiement en attente. Aucun mouvement d'argent. Pas d'événement payment.refunded — la transaction se termine simplement à l'état voided.

Quand utiliser l'un ou l'autre

Situation	Action
Commande expédiée, prête à compenser	Capture
Commande annulée avant expédition, transaction encore autorisée	Void
Commande annulée après capture	Refund
Litige client sur une autorisation non capturée	Void

Configuration mode authorize

Définissez le mode de capture dans le tableau de bord marchand sous Gateways → Configure → Capture Mode → authorize. Une fois défini, chaque paiement via cette passerelle réservera les fonds jusqu'à votre appel à capture ou void.