Remboursements
Rembourser des transactions terminées (`POST /refunds`).
Utilisez POST /refunds pour rembourser une transaction terminée. Les prestataires pris en charge sont carte bancaire, Wave et MTN MoMo (mêmes flux que le tableau de bord). Votre solde est mis à jour immédiatement ; le crédit client dépend du type de paiement.
MTN MoMo (live) : le paiement d'origine doit avoir une référence prestataire (provider_checkout_id issu du RequestToPay). Les remboursements passent par l'API Disbursement MTN (asynchrone côté MTN ; lomi. interroge le statut jusqu'à complétion). En mode test, le remboursement est uniquement comptable (pas d'appel MTN).
Listez et consultez les remboursements avec GET /refunds et GET /refunds/{id}.
Les remboursements carte sont enregistrés immédiatement sur votre compte. Le crédit sur le compte ou la carte du client apparaît en général sous plusieurs jours ouvrés.
Créer un remboursement
import { LomiSDK } from '@lomi./sdk';
const lomi = new LomiSDK({
apiKey: process.env.LOMI_SECRET_KEY!,
environment: 'live',
});
const refund = await lomi.refunds.create({
transaction_id: '123e4567-e89b-12d3-a456-426614174000',
amount: 5000,
reason: 'duplicate_charge',
refund_type: 'partial', // optionnel : 'full' | 'partial'
});import requests, os
r = requests.post(
"https://api.lomi.africa/refunds",
headers={"X-API-KEY": os.environ["LOMI_SECRET_KEY"], "Content-Type": "application/json"},
json={
"transaction_id": "123e4567-e89b-12d3-a456-426614174000",
"amount": 5000,
"reason": "duplicate_charge",
},
)
print(r.status_code, r.json())curl -X POST "https://api.lomi.africa/refunds" \
-H "X-API-KEY: $LOMI_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"transaction_id": "123e4567-e89b-12d3-a456-426614174000",
"amount": 5000,
"reason": "duplicate_charge"
}'Référence du corps
| Champ | Type | Requis |
|---|---|---|
transaction_id | string (UUID) | Oui |
amount | number | Oui |
reason | string | Non |
refund_type | 'full' | 'partial' | Non, déduit de amount vs montant brut si omis |
Lister les remboursements
GET /refunds?status=completed&limit=50&offset=0
Obtenir un remboursement
GET /refunds/{refund_id}