FAQ

Démarrage

Comment créer un compte Business Djamo et obtenir l'accès à l'API ?

Pour commencer, suivez le guide d'intégration. Une fois votre compte examiné et approuvé, vous recevrez vos identifiants API pour démarrer votre intégration.

Existe-t-il un environnement sandbox pour les tests ?

Oui. Djamo fournit un environnement de test dédié pour que vous puissiez développer et valider votre intégration en toute sécurité, sans traiter de transactions réelles. Consultez la section Les bases pour les instructions de configuration.

Paiements (Collecte)

Mes clients pourront-ils payer via mobile money ?

Pas actuellement — l'API Business Djamo prend en charge uniquement les paiements Djamo vers Djamo.

Quel est le montant maximum que je peux recevoir ?

La limite de réception est de 200 000 000 FCFA. Pour les limites spécifiques à votre compte, contactez-nous via la page Contact.

Comment savoir quand un paiement a été effectué avec succès ?

Djamo envoie des notifications d'événements en temps réel via des webhooks à votre endpoint configuré sur le topic charge/events. Consultez la section Événements pour les événements disponibles et les détails des payloads.

Comment savoir si un paiement a échoué ou expiré ?

Les paiements non complétés dans un délai d'1 heure sont automatiquement marqués comme dropped, et un webhook est envoyé sur le topic charge/events. Vous pouvez également interroger GET /v1/charges/:id et vérifier que le champ status est dropped. Voir Récupérer une charge.

Note

Le cycle de vie complet d'une charge — y compris tous les statuts et le TTL — est documenté dans la documentation de l'API de collecte.

Comment tester les paiements en staging ?

En staging, vous ne pouvez pas utiliser l'application Djamo pour payer une charge. Utilisez plutôt l'endpoint de paiement pour simuler des paiements avec des numéros de téléphone de test. Consultez la section Payer une charge (Staging).

Transferts

Y a-t-il des limites sur les montants de transfert ?

Le montant maximum de transfert est de 200 000 000 FCFA. Pour les limites spécifiques à votre compte, contactez-nous via la page Contact.

Comment les mises à jour de statut des transferts sont-elles transmises ?

Les événements du cycle de vie des transferts sont envoyés à votre endpoint via des webhooks. Vous recevrez des notifications à trois étapes : transactions/started, transactions/completed et transactions/failed. Consultez la section Événements pour les détails complets et les formats de payload.

Webhooks

Comment diagnostiquer la non-réception des webhooks ?

Vérifiez votre configuration webhook. Assurez-vous d'avoir souscrit à charge/events pour la collecte de paiements, et à transactions/started, transactions/completed et transactions/failed pour les transferts.
Vérifiez que votre endpoint est accessible publiquement. Djamo doit pouvoir atteindre votre serveur via internet — les URLs localhost ne fonctionneront pas.
Consultez les journaux de votre serveur. Confirmez que votre endpoint reçoit la requête et retourne un code HTTP 200. Une réponse non-200 peut provoquer des relances ou des événements manqués.
Vérifiez la validation de la signature webhook. Un secret mal configuré entraînera le rejet des événements de votre côté.
Contactez le support si le problème persiste.