Prérequis d'intégration

Rassemblez ces éléments avant de commencer une intégration iPayMoney.

Compte marchand

Vous devez disposer d’un compte iPayMoney actif. Après l’inscription et la confirmation de l’adresse e-mail, le compte Sandbox permet de tester l’intégration. L’encaissement réel nécessite un compte Live validé.

Consulter la procédure de création et d’activation du compte

Clés API

La section Développeurs → Clés API du dashboard fournit une clé publique et une clé secrète pour chaque environnement.

Clé	Usage
Clé publique	SDK ou intégration explicitement conçue pour une clé côté client.
Clé secrète	Appels API effectués par votre serveur avec Authorization: Bearer.

Une clé Sandbox ne fonctionne qu’avec Ipay-Target-Environment: sandbox. Une clé Live ne fonctionne qu’avec Ipay-Target-Environment: live.

Serveur d’intégration

Votre serveur doit pouvoir :

• envoyer et recevoir du JSON par HTTPS ;
• conserver la clé secrète hors du code source ;
• produire un transaction_id unique par paiement ;
• stocker les références iPayMoney ;
• exposer une URL HTTPS publique si vous utilisez les webhooks ;
• traiter plusieurs fois la même notification sans dupliquer une commande ou un crédit.

Informations de transaction

L’API de paiement standard attend au minimum : amount, country, currency, msisdn, transaction_id et customer_name. Les pays acceptés par ce contrat sont actuellement BJ et NE, et la devise acceptée est XOF.

Les moyens de paiement et leurs seuils sont détaillés dans la Référence API.