CUA Pay

Objet du service

CUA Pay permet aux citoyens de régler leurs redevances municipales depuis leur téléphone mobile, sans déplacement au guichet. Le service est utilisé par plusieurs applications de la Commune :

Une seule intégration opérateur est mutualisée entre ces applications, ce qui garantit un traitement identique des paiements et une piste d'audit unique pour la Commune.

Opérateurs

L'ouverture des comptes marchands et les conventions avec les opérateurs relèvent de la Commune. Les intégrations techniques sont développées et testées à mesure que les accès sont délivrés ; tant qu'un opérateur n'est pas actif, il est présenté comme indisponible aux agents plutôt que de produire une erreur.

L'opérateur est déterminé automatiquement à partir du préfixe du numéro saisi. Un préfixe ne correspondant à aucun opérateur est rejeté : aucune requête n'est envoyée « au hasard ».

Parcours d'un paiement

Deux parcours coexistent selon que le paiement est engagé par le citoyen lui-même ou par un agent de la Commune. Dans les deux cas, seul le citoyen valide le débit, sur son propre téléphone et avec son code secret : ni l'agent ni la Commune ne peuvent confirmer un paiement à sa place.

A — Paiement engagé par le citoyen (en ligne)

1. Le citoyen consulte le montant dû sur la plateforme municipale (IFPB, Marchés, État civil) et saisit son numéro mobile.
2. La plateforme appelle CUA Pay, qui enregistre la demande puis sollicite l'opérateur correspondant.
3. L'opérateur invite le citoyen à confirmer le paiement sur son téléphone (saisie du code secret).
4. CUA Pay obtient le statut définitif de l'opérateur — par notification (webhook) ou par interrogation — puis le met à disposition de la plateforme.
5. Les fonds sont crédités directement sur le compte marchand de la Commune. La quittance est émise par la plateforme municipale.

B — Paiement engagé par un agent (au guichet ou sur le terrain)

1. L'agent ouvre le dossier concerné et saisit le numéro mobile du citoyen présent devant lui.
2. L'agent choisit le mode de règlement : espèce, MVola, Orange Money ou Airtel Money.
3. Pour un règlement mobile, le citoyen reçoit une invitation USSD sur son téléphone et valide avec son code secret.
4. L'opérateur notifie CUA Pay du résultat ; l'écran de l'agent passe automatiquement à « payé » sans ressaisie.
5. Le reçu est délivré par l'application municipale. Un encaissement en espèce est enregistré au nom de l'agent qui l'a confirmé.

Circuit des fonds

Sécurité

Démonstration

Le parcours de paiement complet peut être essayé directement, sans compte ni identifiants :

Essayer le parcours de paiement

Interface pour les applications municipales

Les applications de la Commune consomment une interface REST unique :

POST /api/v1/payments
Authorization: Bearer <clé de l'application>

{
  "msisdn":      "034XXXXXXX",
  "amount":      50000,
  "reference":   "IFPB-2026-00042",
  "description": "IFPB 2026 - parcelle 12-4-07"
}

La réponse identifie le paiement, dont l'état est ensuite consultable :

GET /api/v1/payments/{id}

{
  "id":       "pay_...",
  "operator": "mvola",
  "state":    "pending",     // puis "succeeded" ou "failed"
  "amount":   50000,
  "currency": "Ar"
}

Les applications municipales n'ont donc jamais à connaître les spécificités de chaque opérateur : l'ajout d'Orange Money ne demandera aucune modification de leur côté.

Contact