Bonnes pratiques générales

Cette section résume les règles métier transversales et les pratiques recommandées pour garantir la fiabilité des transactions.

Principes généraux

Principe	Description
Automatisation intelligente	Préférez l’automatisation via API tout en respectant le rate limit (15 minutes par appel)
Sécurité	Ne partagez jamais vos clés API. Utilisez HTTPS pour toutes les requêtes. Stockez les clés de manière sécurisée
Gestion des erreurs	Implémentez un suivi systématique des transactions FAILED et des codes HTTP (429, 400, 500)
Surveillance et reporting	Centralisez les logs des transactions et des IPN pour audit et suivi. Conservez les informations de `transaction_id`, `custom_data`, et `state`

L’IPN est la source principale pour confirmer le succès ou l’échec d’une transaction.

Avant d’envoyer une transaction, vérifiez :

Numéro valide : Numéro du bénéficiaire valide et conforme à l’opérateur
Montant dans les limites : Montant respectant les plafonds (min: 500, max: 500 000 FCFA) et multiple de 100
Service ID correct : service_id correspondant à l’opérateur et au type d’opération (Cashin/Cashout)
Devise = FCFA : Toutes les transactions doivent être en FCFA

Fractionner les transactions : Implémentez une logique interne pour fractionner les transactions si nécessaire
Respecter les restrictions : Respectez les restrictions géographiques et les limites par type de transaction

En suivant ces bonnes pratiques, vous garantissez une intégration robuste et fiable avec l’API KAYBIC AFRICA .