Consulter une souscription

État de la demande (en_attente_paiement, payee, expiree), dernière tentative de paiement Mobile Money et numéro du contrat une fois payée.

GEThttps://api.coveraf.com/v1/souscriptions/{id}

Réponse JSON 200Sandbox et production

Suivre un paiement Mobile Money

Sans notifications, consultez la souscription toutes les 5 secondes pendant 3 minutes au plus : statut passe à payee et contrat.numero apparaît.

En-têtes

En-tête	Obligatoire	Valeur
`Authorization`	oui	Bearer suivi de votre clé API (`cvr_test_...` ou `cvr_live_...`).

Paramètres de chemin

Champ	Type	Obligatoire	Description
`id`	texte	oui	Identifiant de la souscription (sou_...).

Exemple de requête

curl https://api.coveraf.com/v1/souscriptions/sou_bd4094da89da4a2e0e6078de \
  -H "Authorization: Bearer $COVERAF_CLE_API"

Réponse

Succès (200), réponse réelle de la sandbox

{
  "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"
}

Description de chaque champ : modèle Souscription.

Erreurs possibles

Code	HTTP	Signification
`introuvable`	404	Ressource introuvable.

S'y ajoutent les erreurs communes à tous les appels (clé, signature, limite de débit, service) : voir Codes d'erreur.