FAQ développeur

Réponses courtes aux questions les plus fréquentes. Pour le détail, suivez les liens vers les pages dédiées.

Intégration

Quels opérateurs et quelle devise sont pris en charge ?

Airtel Money et Moov Money au Tchad, en XAF (Franc CFA CEMAC). Le champ operator accepte AIRTEL ou MOOV.

Puis-je tester sans paiement réel ?

Oui. Utilisez une clé kadryza_test_… : les transactions sont créées en sandbox (is_test: true) et ne déclenchent aucun mouvement d’argent réel. Voir Test et production.

Comment obtenir une clé API ?

Depuis le dashboard : API Keys → Créer une clé. La clé est affichée une seule fois. L’environnement (test/live) est déduit du préfixe de la clé.

Quel est le format attendu d’un paiement ?

• amount : entier en XAF (ex. 5000, jamais 5000.50) ;
• phone_number : format international +235XXXXXXXX ;
• currency : "XAF" ;
• reference : votre identifiant de commande (sert aussi à l’idempotence).

Webhooks

Comment vérifier qu’un webhook vient bien de Kadryza ?

Vérifiez l’en-tête X-Kadryza-Signature (sha256=<hmac>), un HMAC-SHA256 du corps brut signé avec votre secret webhook (whsec_…). Détails et exemple sur la page Sécurité.

Que se passe-t-il si mon endpoint est indisponible ?

En cas de réponse non 2xx, Kadryza considère la livraison comme échouée et réessaie. Rendez votre traitement idempotent pour absorber d’éventuels doublons.

Quels événements vais-je recevoir ?

transaction.success, transaction.failed, transaction.timeout (et transaction.test en sandbox), ainsi que payment_session.succeeded, payment_session.expired, payment_session.under_review.

Statuts & délais

Combien de temps prend une confirmation ?

Le délai dépend de l’opérateur et de l’action du client sur son téléphone. Une transaction passe de PENDING à un statut final (SUCCESS, FAILED ou TIMEOUT). Ne considérez un paiement comme acquis qu’au statut SUCCESS (confirmé par webhook).

Dois-je faire du polling ?

Préférez les webhooks pour réagir en temps réel. La consultation de transaction reste possible en complément, mais ne remplace pas la réception du webhook signé.

Disponibilité

Kadryza est-il ouvert à tous ?

Non : Kadryza Pay est en preview privée au Tchad et intègre les marchands progressivement. Demandez un accès anticipé.

Le SDK et les plugins e-commerce sont-ils disponibles ?

Le SDK @kadryza/sdk et les plugins (WooCommerce, PrestaShop) sont en cours de finalisation. La documentation correspondante décrit l’usage cible ; certaines parties peuvent évoluer avant la publication. En attendant, l’intégration directe via l’API REST est pleinement utilisable.

Quelles sont les URLs ?