GuidesEncaisserRemboursement

Remboursement

Un remboursement se fait sur un paiement réussi, en entier ou en partie, jamais au-delà de ce qui reste réellement disponible.

Ce qui reste remboursable

Les remboursements réussis, en cours et incertains sont tous déduits avant d’accepter une nouvelle demande.

GET/v1/payment-intents/{id}/refundscURL

curl "$PAYMENT_OS_API/v1/payment-intents/pay_7c1e…/refunds" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -H "X-Environment: test"

Demander le remboursement

POST/v1/refundscURL

curl -X POST "$PAYMENT_OS_API/v1/refunds" \
  -H "Authorization: Bearer $PAYMENT_OS_KEY" \
  -H "X-Merchant-ID: $MERCHANT_ID" \
  -H "X-Environment: test" \
  -H "Idempotency-Key: CMD-2026-0412-remb-1" \
  -d '{ "payment_id": "pay_7c1e…", "amount": "24.90", "reason": "returned_item" }'

Motifs : returned_item, goodwill, amount_error, other. Le résultat arrive par refund.updated ; un remboursement incertain est vérifié auprès du prestataire avant toute nouvelle tentative.