GuidesEncaisserPaiement complet

Paiement complet

Le paiement de bout en bout : création, caisse, authentification de l’acheteur, confirmation, et capture différée quand votre compte le permet.

Quel compte encaisse

Indiquez connection_id pour choisir le compte. Sans lui, le routage choisit parmi vos comptes admissibles et garde la raison de son choix, lisible avec GET /v1/payment-intents/{id}/route. Le compte ne change plus ensuite.

Les états d’un paiement

PLANNEDDISPATCHEDREQUIRES_ACTIONPROCESSINGSUCCEEDED

Le chemin habituel

REQUIRES_PAYMENT_METHOD : la caisse attend la carte
REQUIRES_ACTION : la banque demande l’acheteur (3-D Secure)
DECLINED_CONFIRMED : refus certain, rien n’a été débité
INDETERMINATE : le résultat n’est pas certain ; ne recréez pas de paiement, PayHaze le vérifie
CANCELED : annulé avant débit

Capture différée

Avec capture_mode manual, l’argent est réservé puis capturé plus tard, une seule fois, partiellement si le prestataire le permet.

POST/v1/payment-intents/{id}/capturecURL

curl -X POST "$PAYMENT_OS_API/v1/payment-intents/pay_7c1e…/capture" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -H "X-Environment: test" \
  -H "Idempotency-Key: CMD-2026-0412-capture" \
  -d '{ "amount": "100.00" }'