Remboursements
Remboursez un paiement réussi, en totalité ou en partie.
Un remboursement est asynchrone. Seuls les paiements succeeded peuvent être remboursés.
Clé privée requise
Les remboursements exigent la clé privée (sk...).
Marketplaces : agir pour le compte d'un sous-compte
Une plateforme peut rembourser le paiement d'un sous-compte connecté en envoyant un en-tête
X-Sync avec sa propre clé (capacité refunds requise). Consultez
Sous-comptes pour les règles et les cas d'erreur.
Endpoints
| Méthode | Chemin | Description |
|---|---|---|
POST | /refunds | Créer un remboursement |
GET | /refunds | Lister les remboursements |
GET | /refunds/{id} | Récupérer un remboursement |
Les remboursements d'un seul paiement
Pour ne lister que les remboursements d'un paiement donné, utilisez plutôt GET /payments/{id}/refunds : mêmes objets, déjà filtrés. Cette ressource
(/refunds) est la ressource canonique, de premier niveau : utilisez-la pour créer un
remboursement ou en retrouver un par son propre id.
Cycle de vie
Événements
| Événement | Déclencheur |
|---|---|
refund.created | Remboursement créé |
refund.processing | Remboursement soumis à l'opérateur. Live uniquement : un remboursement sandbox est créé processing et ne l'envoie jamais |
refund.succeeded | Remboursement confirmé |
refund.failed | Remboursement échoué |
refund.cancelled | Arrêté par Wajub avant son envoi. Aujourd'hui, un tel remboursement est annoncé en refund.failed |
refund.updated | Le execution_mode ou le manual_reason d'un remboursement live a changé. Qui envoie un remboursement live |