Skip to main content
Payer une facture

Requête

Les « factures » de l’API correspondent aux commandes (Order) accessibles par leur UUID public.

Paramètres de chemin

Corps de la requête

Le paiement se fait sur une page de paiement Mobile Money hébergée (MTN, Orange, Airtel… selon le pays).

Réponse (200 OK)

Statut d’un paiement

{reference} est la valeur payment_id renvoyée par POST …/pay. Vous pouvez aussi passer l’identifiant numérique interne du paiement si vous le connaissez. Permission : invoices:read

Réponse

Les statuts possibles pour status : pending, paid, failed, expired.

Webhooks

Les événements sortants documentés côté compte (ex. payment.completed, payment.failed) restent la source fiable pour l’automatisation. Configurez-les dans l’espace client → API → Webhooks.

Permissions requises

  • POST …/invoices/{uuid}/pay : invoices:pay
  • GET …/payments/{reference} : invoices:read
Les clés sandbox (kh_test_) ne permettent pas d’initier un paiement : toute écriture renvoie 403 avec sandbox_read_only.