Mode B : Mobile Money

Pour les partenaires sans moyen d'encaissement. COVERAF encaisse votre client en Mobile Money ; vous êtes prévenu du résultat.

Mode B : la réponse arrive tout de suite, le résultat du paiement ensuite.

Lancer le paiement

POSThttps://api.coveraf.com/v1/souscriptions/{id}/paiement

Requête

{
  "operateur": "orange",
  "telephone_payeur": "0700000001",
  "url_retour": "https://app.votre-societe.ci/paiement/retour"
}

Réponse 201 : paiement en attente

{
  "id": "sou_f6ac5791c1dd467dd238607f",
  "objet": "souscription",
  "environnement": "test",
  "statut": "en_attente_paiement",
  "devis_id": "dev_44cfca8ed08b74ff676b9474",
  "montant_a_payer": {
    "montant": 12980,
    "devise": "XOF"
  },
  "mode_paiement": "jeko",
  "date_effet_prevue": "2026-11-04",
  "souscripteur": {
    "nom": "KONE",
    "prenom": "Awa",
    "telephone": "+2250701020304"
  },
  "reference_partenaire": "CMD-2026-0042",
  "paiement": {
    "id": "pay_e6bf7dd3fd60f74b08c1fef9",
    "statut": "en_attente",
    "operateur": "orange",
    "montant": 12980,
    "lien_paiement": "http://localhost:3005/sandbox/paiement/pay_e6bf7dd3fd60f74b08c1fef9",
    "motif_echec": null,
    "cree_le": "2026-11-04T17:35:45.931257+00:00"
  },
  "contrat": null,
  "expire_le": "2026-11-19T17:35:42.74+00:00",
  "payee_le": null,
  "cree_le": "2026-11-04T17:35:43.359143+00:00"
}

Détail des champs et des erreurs : Lancer un paiement (mode B).

Le client valide le paiement sur son téléphone, ou sur la page lien_paiement si elle est fournie : ouvrez-la dans un navigateur, il revient ensuite sur votre url_retour.

Connaître le résultat

Deux façons, utilisez l'une ou l'autre, ou les deux :

notification sur votre serveur : paiement.reussi puis contrat.emis, ou paiement.echoue (voir Notifications) ;
consultation : GET /v1/souscriptions/{id}, par exemple toutes les 5 secondes pendant 3 minutes.

GET /v1/souscriptions/{id} après paiement

{
  "id": "sou_f6ac5791c1dd467dd238607f",
  "objet": "souscription",
  "environnement": "test",
  "statut": "payee",
  "devis_id": "dev_44cfca8ed08b74ff676b9474",
  "montant_a_payer": {
    "montant": 12980,
    "devise": "XOF"
  },
  "mode_paiement": "jeko",
  "date_effet_prevue": "2026-11-04",
  "souscripteur": {
    "nom": "KONE",
    "prenom": "Awa",
    "telephone": "+2250701020304"
  },
  "reference_partenaire": "CMD-2026-0042",
  "paiement": {
    "id": "pay_e6bf7dd3fd60f74b08c1fef9",
    "statut": "reussi",
    "operateur": "orange",
    "montant": 12980,
    "lien_paiement": null,
    "motif_echec": null,
    "cree_le": "2026-11-04T17:35:45.931257+00:00"
  },
  "contrat": {
    "numero": "TEST-CVR-API-MW2EE3CW-0845CBC0B0",
    "adresse": "/v1/contrats/TEST-CVR-API-MW2EE3CW-0845CBC0B0"
  },
  "expire_le": "2026-11-19T17:35:42.74+00:00",
  "payee_le": "2026-11-04T17:35:49.232+00:00",
  "cree_le": "2026-11-04T17:35:43.359143+00:00"
}

Opérateurs

operateur	Libellé
`orange`	Orange Money
`mtn`	MTN Mobile Money
`moov`	Moov Money
`wave`	Wave
`djamo`	Djamo

Après un échec

La souscription reste en attente : votre client peut réessayer, avec le même opérateur ou un autre. Lancez simplement un nouveau paiement (avec une nouvelle Idempotency-Key). Un seul paiement peut être en cours à la fois : sinon paiement_deja_en_cours.

Motifs d'échec possibles : voir Constantes.

En sandbox

Aucun opérateur n'est contacté. Le résultat arrive 3 secondes plus tard et dépend du numéro : 0700000001 réussit, 0700000002 à 0700000004 échouent. Voir Sandbox.