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. Avec une clé kadryza_test_…, tout ce que vous créez est isolé en environnement de test et ne déclenche aucun mouvement d’argent réel. Une Payment Session de test n’est confirmée que si un crédit est observé sur un numéro de test ; pour simuler des issues, utilisez les transactions sandbox. 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) ;
• currency : "XAF" ;
• operator : AIRTEL ou MOOV (Payment Session) ;
• customer_phone : format international +235XXXXXXXX, obligatoire en live ;
• reference : votre identifiant de commande, unique par environnement.

Voir Payment Sessions.

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 le secret de votre endpoint webhook. 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 (ou sans réponse en 10 secondes), Kadryza réessaie : 1 min, 5 min, 30 min puis 2 h après chaque échec. Dédupliquez sur event_id pour absorber les doublons.

Quels événements vais-je recevoir ?

payment_session.succeeded, payment_session.under_review, payment_session.expired (sessions de test), ainsi que transaction.success, transaction.failed, transaction.timeout pour l’API historique et transaction.test pour les envois de test. Voir Webhooks.

Statuts & délais

Combien de temps prend une confirmation ?

Le délai dépend du moment où votre client envoie l’argent et de l’opérateur. Une Payment Session reste AWAITING_PAYMENT jusqu’à sa décision. Ne considérez un paiement comme acquis qu’au statut SUCCESS. Aujourd’hui, un paiement live reçu est d’abord placé en UNDER_REVIEW (vérification) : ne relancez pas de second paiement.

Dois-je faire du polling ?

Préférez les webhooks. La lecture de la session reste possible en complément, au plus une fois toutes les 5 secondes pendant AWAITING_PAYMENT.

Disponibilité

Kadryza est-il ouvert à tous ?

Kadryza Pay intègre les marchands progressivement au Tchad et en zone CEMAC. Demandez un accès pour démarrer votre intégration.

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

Le SDK @kadryza/sdk n’est pas encore publié sur npm. WooCommerce 2.0 et PrestaShop 2.0 sont prêts pour des pilotes production contrôlés avec Hosted Checkout. L’intégration officielle Shopify arrive bientôt. L’intégration directe via l’API REST est pleinement utilisable.

Quelles sont les URLs ?