Paiement fractionné
Simuler, créer et suivre un échéancier.
Comment ça marche ici
Le payeur règle un acompte, puis les échéances suivantes. Il n'y a aucun prélèvement automatique : à chaque échéance le payeur est sollicité et règle depuis son portail. C'est la réalité du mobile money dans l'UEMOA — un mandat de prélèvement n'est pas acquis.
Le paiement fractionné doit être activé sur votre compte par l'administration avant de pouvoir être proposé.
POST /api/v1/installment_plans/simulate
Dit si ce montant est éligible, et avec quelles formules. Ne crée rien.
curl -X POST https://maticorp.tech/api/v1/installment_plans/simulate \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{"amount": 90000, "msisdn": "0190000000"}'
{
"object": "installment_simulation",
"amount": 90000,
"eligible": true,
"reasons": [],
"options": [ ... ]
}
Quand eligible vaut false, reasons dit
pourquoi — en clair, affichable au payeur.
POST /api/v1/installment_plans
-d '{
"amount": 90000,
"installments_count": 3,
"msisdn": "0190000000",
"payer_name": "Koné Ibrahim",
"description": "Téléviseur 43 pouces"
}'
La réponse porte le plan et l'encaissement de l'acompte. Le plan
reste propose tant que cet acompte n'est pas abouti : un plan
n'est actif qu'une fois le premier franc reçu.
GET /api/v1/installment_plans/{id}
État du plan et de chacune de ses échéances.
Une note sur votre marge
Un plan en trois fois supporte trois coûts de rail, pas un seul. La commission du fractionné en tient compte, mais gardez-le en tête quand vous comparez au paiement comptant.