Documentation de l’API

Galsen Pay

Galsen Pay est une API d’orchestration de paiements mobile money pour le Sénégal. Votre serveur appelle une seule API ; Galsen Pay parle aux fournisseurs (Wave, et d’autres à venir), suit chaque paiement jusqu’à son issue réelle, tient une comptabilité en partie double de ce qui vous revient, et prévient votre serveur par des webhooks signés.

Ce que vous pouvez faire

Encaisser : créer un paiement, rediriger le client vers la page du fournisseur, recevoir la confirmation (Paiements).
Rembourser un paiement, en totalité ou en partie si le fournisseur le permet (Remboursements).
Verser de l’argent de votre solde vers un portefeuille mobile money (Versements).
Suivre votre solde, vos mouvements comptables, vos clients et vos exports depuis l’API ou le tableau de bord.

État des moyens de paiement

Fournisseur	Code API	État
Simulateur	`SANDBOX`	Disponible en mode test. Rejoue toute la chaîne (webhook signé, comptabilité, solde) sans argent réel.
Wave	`WAVE`	Intégré selon la documentation officielle de Wave. Pas encore ouvert aux opérations réelles : voir Passer en production.
Orange Money	`ORANGE_MONEY`	Pas encore disponible : un appel répond `501 PROVIDER_DOCUMENTATION_REQUIRED`.

Environnements

L’environnement dépend du déploiement, jamais d’un paramètre de requête. Le déploiement de test, ouvert aujourd’hui, répond sur https://backend.v1.pay.galsen.tech et n’accepte que des clés de test (gsp_test_…). Le déploiement de production aura ses propres clés (gsp_live_…) et refusera les clés de test, et inversement.

Aucun argent réel en mode test

En mode test, le seul fournisseur est le simulateur. Rien n’est débité, rien n’est versé : vous pouvez tout essayer.

Par où commencer

Créez un compte marchand (gratuit, en mode test).
Suivez le démarrage rapide : première clé API, premier paiement, premier webhook en une quinzaine de minutes.
Lisez les conventions (montants, idempotence, erreurs) avant d’écrire votre intégration : elles évitent les paiements en double.