FAQ développeur

Quelle clé utiliser avec l’API REST ?

Utilisez la clé secrète de l’environnement ciblé dans Authorization: Bearer. Elle doit rester côté serveur.

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

Non. La clé doit appartenir au même environnement que Ipay-Target-Environment.

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.

Puis-je réutiliser transaction_id ?

Non pour une nouvelle transaction du même compte. Cette référence externe est unique. Une duplication peut retourner 422 External Reference Not Valid.

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

Le numéro doit inclure l’indicatif attendu et correspondre au pays et à un opérateur pris en charge. Vérifiez également que le moyen est activé sur le compte.

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

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

Quels SDK sont actuellement documentés ?

Le dépôt contient un guide JavaScript et un guide WooCommerce. Pour PHP, Java, Flutter ou Android, utilisez l’API REST ou demandez au support de confirmer la disponibilité d’un package officiel.

Où trouver tous les messages d’erreur ?

Consultez la page Codes d’erreur et la Référence API.