Support et aide
Questions fréquentes, erreurs courantes et contact avec l'équipe EasyPay.
Vous utilisez l'application EasyPay ? Le guide utilisateur explique comment relier vos wallets, payer, envoyer et recevoir de l'argent. Pour toute autre question, contactez-nous ci-dessous.
Lire le guide utilisateurQuestions fréquentes
Comment obtenir mes clés API ?
Dans l'application EasyPay — compte marchand ou Espace Pro —, ouvrez Paramètres → API & Integration et générez vos clés : ek_live_… et ek_test_…. Elles ne s'affichent qu'une fois ; si vous les perdez, régénérez-les : les anciennes cessent alors de fonctionner.
Quels frais sont appliqués ?
EasyPay ne prélève que sa commission, selon une politique propre à chaque moyen de paiement : un pourcentage ou un forfait par tranche de montant, payé par le client ou déduit de ce que vous recevez. Les frais du wallet (TOF, TTE, interchange) sont prélevés par le wallet du client. Le barème en vigueur se lit avec GET /api/v1/fees/policies, et le montant exact d'un paiement avec GET /api/v1/fees/quote.
Comment tester mon intégration ?
Créez vos sessions avec votre clé ek_test_, sur la même URL que la production. Le paiement est confirmé aussitôt, sans mouvement d'argent, et le callback checkout.paid porte "sandbox": true. Un client sans compte EasyPay reçoit un vrai code SMS : utilisez un numéro qui reçoit les SMS.
Un client dit avoir payé, mais la commande n'est pas confirmée. Que vérifier ?
Relisez la session avec GET /api/v1/checkout/sessions/{sessionToken}. OPEN : le paiement n'a pas abouti ; s'il vient d'un client sans compte EasyPay, il attend votre validation dans l'application marchande. EXPIRED : les 30 minutes se sont écoulées sans paiement validé — un paiement commencé à temps peut encore l'être. PAID : le paiement est acquis ; si checkout.paid ne vous est pas parvenu, vérifiez votre callbackUrl et votre contrôle de signature.
Erreurs courantes
401 « Invalid API key » ou 400 « Required header 'X-API-Key' is not present »
La clé est inconnue — régénérée depuis ? — ou absente. Sur les endpoints de session de paiement, envoyez-la dans l'en-tête X-API-Key, pas dans Authorization.
X-API-Key: ek_live_…400 à la création d'une session
« Invalid request content. » : title, amount ou returnUrl manque, ou le montant n'est pas positif. « Failed to read request » : le corps n'est pas un JSON valide. « Le montant minimum est de 100 MRU » ou « maximum » : en production, une session va de 100 à 500 000 MRU.
Si vous contactez le support, joignez l'en-tête X-Request-Id de la réponse : il permet de retrouver votre requête.