Kadryza Developers

Encaissez par Mobile Money avec une seule API.

Créez une Payment Session, affichez le numéro de paiement à votre client ou redirigez-le vers la page hébergée, puis recevez un webhook signé. Airtel Money et Moov Money, au Tchad.

Démarrage rapide

Référence API

API v1 Payment Sessions, Hosted Checkout, webhooks
Live sur activation Paiements réels
SDK non publié Node.js

creer-une-session.shclé de test


curl -X POST https://api.kadryza.app/v1/payment-sessions \
  -H "X-API-Key: $KADRYZA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "order_2026_001",
    "amount": 5000,
    "currency": "XAF",
    "operator": "AIRTEL"
  }'
 
# 201 Created
# → status: "AWAITING_PAYMENT"
# → assigned_collection_number : le numéro à payer
# → checkout_url : la page de paiement hébergée

Accès en production. Les clés de test fonctionnent dès la création du compte. Les paiements réels demandent un compte vérifié et une activation par Kadryza ; aujourd’hui, un paiement réel reçu est d’abord placé en vérification (UNDER_REVIEW). Détails : Test et production.

Commencer

Choisissez votre intégration

/quickstart

Démarrage rapide

Clé de test, première Payment Session, webhook signé : l’intégration minimale serveur à serveur.

Commencer /v1/payment-sessions

Payment Sessions

Vous choisissez l’opérateur et affichez vous-même le numéro de paiement dans votre interface.

Référence /v1/hosted-checkouts

Hosted Checkout

Redirigez votre client vers une page Kadryza : il choisit son opérateur et suit son paiement.

Référence /v1/webhooks

Webhooks

Recevez chaque décision de paiement, signée HMAC-SHA256, avec un identifiant d’événement stable.

Configurer

Parcours

Le parcours d’intégration

Chaque étape a sa page. Suivez-les dans l’ordre.

Compte marchand

Créez votre compte, vérifiez votre e-mail et complétez votre profil marchand.

Clé API de test

Générez une clé kadryza_test_… depuis le dashboard. Elle n’est affichée qu’une seule fois.

Premier paiement

Créez une Payment Session ou un Hosted Checkout depuis votre serveur.

Webhooks

Vérifiez la signature, dédupliquez sur event_id, traitez chaque statut.

Passage en production

Déroulez la checklist, obtenez l’activation live et basculez sur votre clé kadryza_live_….

Référence

Référence et outils

/authentication

Authentification

Clés API, portées, conditions d’utilisation.

/environments

Test et production

Ce qui change entre une clé de test et une clé live.

/errors

Codes d’erreur

Chaque code renvoyé par l’API, sa cause et quoi faire.

/security

Sécurité

Stockage des clés, signatures, idempotence.

/sdk

SDK Node.js

Client TypeScript : sessions, webhooks, vérification de signature.

Non publié /plugins

Plugins e-commerce

WooCommerce 2.0 et PrestaShop 2.0 sont prêts pour des pilotes production contrôlés. Shopify arrive bientôt.

Pilote contrôlé

Opérateurs pris en charge

Opérateur	Valeur `operator`	Pays	Devise	Test	Live
Airtel Money	`AIRTEL`	Tchad	XAF (franc CFA CEMAC)	Disponible	Live sur activation
Moov Money	`MOOV`	Tchad	XAF (franc CFA CEMAC)	Disponible	Live sur activation

En test comme en live, la disponibilité d’un opérateur est vérifiée à chaque création de paiement : si son réseau d’encaissement n’est pas prêt, l’API répond 503 avec un code explicite plutôt que d’accepter un paiement qui ne pourrait pas être suivi (Codes d’erreur).

Besoin d’aide ? Consultez la FAQ ou écrivez à contact@kadryza.com.