curl --request POST \
--url https://guichet.apidjonanko.tech/v1/cashin \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--header 'x-api-secret: <api-key>' \
--data '
{
"amount": 5000,
"country": "CI",
"operator": "ORANGE",
"payerPhone": "0701020304"
}
'
{
"operation": {
"reference": "GUI-CI-20261001-7K2M9QX4",
"type": "CASHIN",
"status": "CREATED",
"amount": 5000,
"fees": 100,
"netAmount": 4900,
"currency": "XOF",
"country": "CI",
"operator": "ORANGE",
"counterparty": {
"phoneNumber": "+2250701020304",
"name": "Aya Koné"
},
"externalReference": "CMD-2026-00184",
"description": "Commande 184",
"payerActionUrl": "https://pay.example.com/s/abc123",
"requiresPayerAction": true,
"failure": {
"code": "OPERATOR_INSUFFICIENT_FUNDS",
"message": "Le solde du compte mobile money du payeur est insuffisant."
},
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z"
}
}
Encaissement
Encaisser un paiement
Débite le compte mobile money du payeur et crédite votre portefeuille du montant net une fois l’encaissement confirmé.
Deux comportements selon l’opérateur :
| Opérateurs | Statut renvoyé | Ce que vous avez à faire |
|---|---|---|
| MTN, Moov | PENDING | Rien. Le payeur reçoit une demande de validation sur son téléphone. Attendez la notification. |
| Orange, Wave, Djamo | AWAITING_PAYER | Envoyer votre client sur payerActionUrl. Sans cela l’encaissement n’aboutira jamais. |
L’issue définitive arrive par notification (cashin.succeeded /
cashin.failed). Une opération sans issue au bout de 30 minutes passe en
EXPIRED.
POST
/
cashin
curl --request POST \
--url https://guichet.apidjonanko.tech/v1/cashin \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--header 'x-api-secret: <api-key>' \
--data '
{
"amount": 5000,
"country": "CI",
"operator": "ORANGE",
"payerPhone": "0701020304"
}
'
{
"operation": {
"reference": "GUI-CI-20261001-7K2M9QX4",
"type": "CASHIN",
"status": "CREATED",
"amount": 5000,
"fees": 100,
"netAmount": 4900,
"currency": "XOF",
"country": "CI",
"operator": "ORANGE",
"counterparty": {
"phoneNumber": "+2250701020304",
"name": "Aya Koné"
},
"externalReference": "CMD-2026-00184",
"description": "Commande 184",
"payerActionUrl": "https://pay.example.com/s/abc123",
"requiresPayerAction": true,
"failure": {
"code": "OPERATOR_INSUFFICIENT_FUNDS",
"message": "Le solde du compte mobile money du payeur est insuffisant."
},
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"expiresAt": "2023-11-07T05:31:56Z"
}
}
Authorizations
Headers
Body
application/json
