Skip to main content

Quelle clé utiliser avec l’API REST ?

La clé secrète de l’environnement ciblé, dans Authorization: Bearer. Elle doit rester côté serveur. Détails : Authentification.

Puis-je utiliser une clé Sandbox avec l’environnement Live ?

Non. La clé doit appartenir au même environnement que Ipay-Target-Environment. Détails : Authentification et Mise en route.

Comment savoir si un paiement est réellement réussi ?

Vérifiez côté serveur que GET /api/v1/payments/{reference} retourne status: succeeded, ou traitez un webhook authentifié puis confirmez le statut si l’action est sensible. Détails : Consulter une transaction.

Puis-je réutiliser transaction_id ?

Non : cette référence externe doit être unique pour votre compte, et une duplication retourne 422 External Reference Not Valid en Live (en Sandbox, la réponse n’est pas garantie identique — à confirmer auprès du support ; le paiement n’est pas créé dans les deux cas). Cette détection est appliquée au niveau applicatif et n’est pas garantie sous appels concurrents ; l’API n’expose aucune clé d’idempotence. Générez un transaction_id unique par tentative. Détails : Erreurs.

Pourquoi mon paiement Live retourne-t-il Incorrect MSISDN ?

Ce message ne porte que sur le format du msisdn pour la méthode utilisée : il doit inclure l’indicatif attendu et correspondre au pays et à un opérateur pris en charge. Si le format est correct, l’erreur vient d’ailleurs — vérifiez l’en-tête Ipay-Payment-Type et les droits du compte, qui produisent des réponses distinctes. Détails : Erreurs.

Le webhook remplace-t-il la vérification API ?

Non. Il évite l’interrogation continue, mais la vérification reste utile pour les actions sensibles, le retour utilisateur et la réconciliation. Détails : Webhooks.

Quels SDK sont actuellement documentés ?

Un SDK JavaScript et un module WooCommerce. Pour PHP, Java, Flutter ou Android, aucun guide n’est publié : utilisez l’API REST depuis votre backend, ou demandez au support de confirmer la disponibilité d’un package officiel. Le contrat OpenAPI et la collection Postman sont sur la page Téléchargements.

Où trouver les messages d’erreur ?

Sur la page Erreurs. Pour une demande d’assistance, voir Support.