Aller au contenu

Encaissement

Airtel Money et Moov Money.Une seule intégration.

Votre application crée une session de paiement, votre client paie avec le portefeuille qu’il utilise déjà, et Kadryza vous confirme le paiement avec la référence de l’opérateur.

Compte marchand vérifié avant l’activation des paiements en production.

Airtel Money

Airtel Money

Devise
Franc CFA (XAF)
Requête
POST /v1/payment-sessions
Confirmation
Référence de l’opérateur
État du réseau
Suivi en continu
Moov Money

Moov Money

Devise
Franc CFA (XAF)
Requête
POST /v1/payment-sessions
Confirmation
Référence de l’opérateur
État du réseau
Suivi en continu

Comment ça marche

Trois moments, et un contrat clair à chacun.

  1. Votre application crée la session

    Un appel avec le montant, la devise, la référence de commande et l’opérateur. Kadryza renvoie une session et sa référence de suivi.

  2. Votre client suit l’instruction

    La page de paiement présente le montant et l’instruction de l’opérateur. Votre client y consulte l’état de son paiement, en direct.

  3. Votre serveur reçoit la confirmation

    Il vérifie la signature du webhook et l’état du paiement avant de traiter la commande. Une livraison webhook ne prouve pas la disponibilité des fonds.

Le trajet d’un paiement

Quatre étapes entre le téléphone de votre client et votre caisse. Kadryza suit chacune, garde la preuve de l’opérateur et ne présume jamais de l’issue.

  1. Étape 1 · Session créée

    Votre serveur crée la session

    Montant, devise et référence de commande avec POST /v1/payment-sessions. Kadryza renvoie une référence de suivi.

  2. Étape 2 · Client invité

    Votre client paie avec son portefeuille

    Airtel Money ou Moov Money : la page de paiement affiche le montant, l’instruction à suivre et l’état du paiement, en direct.

  3. Étape 3 · Vérification

    L’opérateur confirme

    Kadryza rapproche la confirmation de l’opérateur et conserve sa référence. Sans réponse, le paiement reste en vérification.

  4. Étape 4 · Confirmé

    Vous êtes prévenu

    Le paiement apparaît dans votre espace et un webhook signé part vers votre serveur. La disponibilité des fonds reste indiquée à part.

Inconnu ne veut pas dire confirmé. Sans réponse de l’opérateur, un paiement reste en vérification : il n’est jamais compté comme réussi, ni ajouté à votre encaissé.

Un contrat d’API

Tous les opérateurs, une seule requête.

Votre code ne connaît qu’un rail. Quand votre client choisit son opérateur, une valeur change dans un champ ; l’intégration, elle, ne bouge pas. Une seule signature à vérifier, un seul format d’événement à traiter.

Créer une sessionExemple
POST /v1/payment-sessions
X-API-Key: <API_KEY>
Content-Type: application/json

{
  "reference": "CMD-10428",
  "amount": 25000,
  "currency": "XAF",
  "operator": "AIRTEL"
}

Côté client

Une page de paiement que vos clients comprennent.

Le nom de votre commerce, le montant, l’instruction de l’opérateur et l’état du paiement, mis à jour en direct. Une référence de suivi accompagne chaque paiement.

Données d’illustration

Les états d’un paiement

Chaque état dit exactement ce qu’il sait. Rien de plus.

  • En attente du clientLa session est créée, votre client n’a pas encore payé. Rien n’est confirmé.
  • En vérificationKadryza vérifie le paiement auprès de l’opérateur. Il n’entre pas encore dans l’encaissé ni dans le solde.
  • ConfirméL’opérateur a confirmé le paiement, avec sa référence. La disponibilité des fonds reste une information distincte.
  • ÉchouéLe paiement n’a pas abouti. Aucune commission ne s’applique.

Inconnu ne veut pas dire confirmé. Tant que l’opérateur n’a pas répondu, le paiement reste en vérification. Il n’est jamais présumé réussi.

FAQ

Questions fréquentes Les réponses courtes.

Une autre question ? Écrivez-nous, on vous répond franchement.

Mon client doit-il installer quelque chose ?
Non. Il paie avec le portefeuille Airtel Money ou Moov Money qu’il utilise déjà, en suivant l’instruction affichée sur la page de paiement.
Puis-je proposer les deux opérateurs ?
Oui. Votre code envoie une seule requête, quel que soit l’opérateur choisi : le champ de l’opérateur change, l’intégration reste la même.
Quand puis-je encaisser en production ?
Après la vérification de votre compte marchand, qui précède l’activation des paiements en production. L’environnement d’intégration est disponible dès la création du compte.
Un webhook reçu prouve-t-il que l’argent est disponible ?
Non. Un webhook signé confirme l’état du paiement. La disponibilité des fonds se consulte séparément, dans votre espace marchand.

Votre premier encaissement commence par un test.

Créez votre compte, générez une clé de test et suivez un paiement de bout en bout dans l’environnement d’intégration, sans argent réel.

Alimentation généralePaiement reçu25 000 XAF · Airtel Money