Skip to main content
Ce parcours mène de la création du compte au premier paiement réel, sans code : ouvrir un compte, comprendre la séparation Sandbox/Live, valider son intégration sur des paiements simulés, puis franchir les étapes du passage en production. Si vous êtes déjà opérationnel en Sandbox, allez directement à Passer en production.

​
Créer son compte

Rendez-vous sur i-pay.money et cliquez sur S’inscrire, en haut à droite de la page d’accueil. Page d'accueil i-pay.money, avec le bouton S'inscrire en haut à droite Renseignez votre adresse e-mail, votre nom, votre numéro de téléphone et un mot de passe, acceptez les conditions d’utilisation, puis validez la création du compte. Un lien de confirmation est envoyé à l’adresse indiquée : cliquez dessus pour activer votre compte, puis connectez-vous avec votre e-mail et votre mot de passe. Vous accédez alors au tableau de bord, qui donne immédiatement accès à l’environnement Sandbox. Vos clés API se récupèrent ensuite depuis ce tableau de bord : où les trouver, comment les utiliser et comment les protéger est décrit dans Authentification.

​
Sandbox et Live

Les deux environnements exposent les mêmes points de terminaison. Seuls la clé utilisée et l’en-tête d’environnement décrits dans Authentification déterminent celui auquel vous vous adressez. Les deux comptes étant entièrement séparés, une clé d’un environnement utilisée avec l’autre environnement retourne une erreur d’authentification, jamais un succès silencieux. Prévoyez donc une configuration par environnement (une variable d’environnement dédiée à chacun) plutôt qu’un simple interrupteur booléen dans votre code.

​
Tester son intégration

En Sandbox, vérifiez le parcours complet, de la création du paiement jusqu’à la confirmation de son statut.
  1. Le client valide sa commande ou sa demande de paiement sur votre site.
  2. Votre serveur crée le paiement avec la clé secrète Sandbox — voir Créer une transaction.
  3. Vous conservez les références renvoyées par iMoney Encaissement et les rattachez à votre commande.
  4. Vous confirmez le statut définitif, par notification ou par consultation, avant de livrer la commande ou d’activer le service payé.
Le statut renvoyé au moment de la création n’est jamais une preuve de paiement suffisante à lui seul : il peut encore évoluer. Ne livrez une commande qu’après un statut confirmé à l’étape 4. Les deux moyens d’obtenir ce statut sont complémentaires plutôt qu’exclusifs : la notification webhook vous prévient dès que le paiement change d’état, la consultation donne le statut à l’instant de l’appel et sert de secours ou de réconciliation. Dans les deux cas, traitez la mise à jour de manière idempotente : une même notification peut arriver deux fois. Couvrez au minimum trois cas avant la production — un paiement réussi, une erreur de validation et un doublon de référence. Les numéros de test, les montants minimums propres à la Sandbox et les requêtes correspondantes sont rassemblés dans la section Sandbox de la fiche Transactions. Si vous déléguez l’interface de paiement à une page hébergée plutôt que de construire votre propre formulaire, le principe reste le même côté serveur : le résultat se vérifie par consultation ou par webhook, jamais sur la seule redirection du client — voir Liens de paiement.

​
Passer en production

  • Faire valider le compte pour l’environnement Live. L’activation n’est pas automatique : elle passe par la soumission des informations légales depuis le tableau de bord, puis par la validation du dossier par l’équipe iMoney Encaissement. L’accès Live n’est ouvert qu’après cette validation — n’annoncez à vos utilisateurs aucun délai d’activation instantané.
  • Confirmer les moyens de paiement activés sur le compte pour le pays ciblé, et n’ouvrir en Live que ceux que vous avez testés en Sandbox.
  • Mettre en place la configuration Live. Les points de terminaison ne changent pas ; seuls la clé et l’environnement ciblé changent. Conservez la clé secrète Live dans le gestionnaire de secrets de production, dans une variable distincte de celle de la Sandbox — voir Authentification.
  • Vérifier les notifications en environnement Live. Un webhook configuré en Sandbox ne s’applique pas à vos flux Live : reconfigurez-le avec une URL HTTPS publique et stable, un secret propre à cet environnement et les mêmes événements qu’en Sandbox — voir Webhooks.
  • Confirmer chaque paiement côté serveur avant toute livraison, et réconcilier régulièrement ceux restés en attente — voir Consulter une transaction.
  • Revoir le traitement des erreurs. Une erreur de validation ou d’accès n’est pas un incident transitoire : corrigez la requête plutôt que de la rejouer à l’identique, et en cas d’absence de réponse, vérifiez le statut du paiement avant toute nouvelle tentative — voir Erreurs.
  • Sécuriser les échanges : HTTPS pour votre application comme pour l’URL de votre webhook, appels à l’API depuis votre serveur uniquement, et clés, numéros de téléphone et données de paiement masqués dans vos journaux.
  • Effectuer un paiement réel contrôlé de faible montant avant d’ouvrir le service à tous vos utilisateurs : confirmez la réception effective de la notification et la cohérence du statut consulté, et mettez en place vos alertes sur les erreurs API, les webhooks hors 2xx et les paiements durablement en attente.