Remboursements
Remboursez une transaction, totalement ou partiellement, directement via l'API.
Créer un remboursement
POST
https://api.germinopay.com/v1/paiement/{reference}/rembourser
| Champ | Type | Requis | Description |
|---|---|---|---|
montant |
number | Non | Montant à rembourser. Si omis, le montant total est remboursé. |
raison |
string | Non | Motif du remboursement (visible par le client). |
curl -X POST https://api.germinopay.com/v1/paiement/GP-20251001-ABC123/rembourser \
-H "Content-Type: application/json" \
-H "X-Public-Key: pk_live_xxxx" \
-H "X-Timestamp: 1730000000" \
-H "X-Signature: hmac_sha256_signature" \
-d '{
"raison": "Client a demandé un remboursement"
}'
200 OK
{
"success": true,
"message": "Refund initiated",
"data": {
"refund_id": "rfd_a1b2c3d4e5",
"reference": "GP-20251001-ABC123",
"montant_rembourse": 5000,
"devise": "XOF",
"statut": "en_cours",
"raison": "Client a demandé un remboursement",
"created_at": "2025-10-01T15:00:00Z"
}
}
Remboursement partiel
curl -X POST https://api.germinopay.com/v1/paiement/GP-20251001-ABC123/rembourser \
-H "Content-Type: application/json" \
-H "X-Public-Key: pk_live_xxxx" \
-H "X-Timestamp: 1730000000" \
-H "X-Signature: hmac_sha256_signature" \
-d '{
"montant": 2000,
"raison": "Article retourné partiellement"
}'
Statuts de remboursement
| Statut | Signification |
|---|---|
| en_cours | Le remboursement est en cours de traitement par le fournisseur. |
| rembourse | Remboursement terminé. Le montant a été déduit de votre solde. |
| echoue | Remboursement échoué (solde insuffisant, délai dépassé...). |
Règles et limites
- Vous pouvez rembourser jusqu'au montant total de la transaction d'origine.
- Plusieurs remboursements partiels sont autorisés tant que le cumul ne dépasse pas l'original.
- Fenêtre de remboursement : 180 jours pour PayPal, 90 jours pour les fournisseurs mobile money.
- Les frais sur la transaction originale ne sont pas remboursés.
Solde requis
Votre solde marchand doit être suffisant pour couvrir le remboursement. Sinon la demande est rejetée.