Créer une application
Ce qu'une application configure et pourquoi.
Une application est votre unité d'intégration. Vos transactions, clés API,
endpoints webhook et wallets sont tous rattachés à une application et à un
environnement (sandbox ou production).
Ce que porte une application
- Pays et opérateurs activés — la liste des opérateurs de votre application
est renvoyée par
GET /v1/operators. - Délai de settlement — un délai de mise à disposition des fonds encaissés peut être fixé au niveau de l'application. Il prime sur le délai par défaut de l'opérateur. Voir Settlement différé.
- URLs de retour —
successUrl,failedUrl,cancelUrl,returnUrlpar défaut. Vous pouvez les surcharger par opération. - Endpoints webhook — une ou plusieurs URLs signées, destinataires des événements de paiement.
- Wallets — des wallets (PAYIN, PAYOUT) par pays et devise. Voir Wallets.
Environnements
| Environnement | Usage |
|---|---|
sandbox | Tests d'intégration. Résultats déterministes par numéro de test. |
production | Trafic réel. Clés et wallets séparés de la sandbox. |
Les clés API, wallets et transactions ne sont jamais partagés entre
sandbox et production. Commencez toujours en sandbox.
Étapes
Créez et configurez votre application dans la console d'administration FreeGate. Une fois l'application créée :
- Activez les pays et opérateurs dont vous avez besoin.
- Générez une clé API sandbox.
- Déclarez un endpoint webhook. Optionnel pour un premier test.