> ## Documentation Index
> Fetch the complete documentation index at: https://docs.i-pay.money/llms.txt
> Use this file to discover all available pages before exploring further.

# Mise en route

> Créez votre compte, testez votre intégration en Sandbox et passez en production.

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](#passer-en-production).

## Créer son compte

Rendez-vous sur [i-pay.money](https://i-pay.money) et cliquez sur **S'inscrire**, en haut à droite de la page d'accueil.

<img src="https://mintcdn.com/i-futur/tjF0ZxfaRtlg4lqv/documentation-assets/hero-section.png?fit=max&auto=format&n=tjF0ZxfaRtlg4lqv&q=85&s=ab9be95e98607b3bae41ecfc0633d9e8" alt="Page d'accueil i-pay.money, avec le bouton S'inscrire en haut à droite" width="1432" height="805" data-path="documentation-assets/hero-section.png" />

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](/api-reference/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](/api-reference/authentification) déterminent celui auquel vous vous adressez.

| Environnement | Paiements                                                          | Comptes                                       | Accès                                                                                 |
| ------------- | ------------------------------------------------------------------ | --------------------------------------------- | ------------------------------------------------------------------------------------- |
| Sandbox       | Paiements simulés, aucun mouvement d'argent réel                   | Compte distinct, avec sa propre paire de clés | Ouvert dès la confirmation de l'inscription                                           |
| Live          | Paiements réels, avec les moyens de paiement activés sur le compte | Compte distinct, avec sa propre paire de clés | Ouvert après validation du compte, voir [Passer en production](#passer-en-production) |

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](/api-reference/transactions#post-payments).
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](/guides/webhooks) vous prévient dès que le paiement change d'état, la [consultation](/api-reference/transactions#get-payments-reference) 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](/api-reference/transactions#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](/api-reference/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](/api-reference/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](/guides/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](/api-reference/transactions#get-payments-reference).
* **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](/api-reference/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.
