Tous les endpoints
Adresse de base : https://backend.v1.pay.galsen.tech. « Tableau de bord » : réservé aux comptes connectés au tableau de bord, jamais accessible à une clé API.
Paiements
| Méthode | Chemin | Droit | Rôle |
|---|---|---|---|
| POST | /v1/payment-intents | payments:write | Créer un paiement. Idempotency-Key obligatoire. |
| GET | /v1/payment-intents | payments:read | Lister (filtres status, provider, reference, amountMin/Max, createdFrom/To). |
| GET | /v1/payment-intents/{id} | payments:read | Lire un paiement. |
| POST | /v1/payment-intents/{id}/cancel | payments:write | Annuler un paiement non terminé. |
| POST | /v1/payments | payments:write | Alias de POST /v1/payment-intents. |
| GET | /v1/payments | payments:read | Paiements encaissés (refundableAmount, settledAt). |
| GET | /v1/payments/{id} | payments:read | Un paiement encaissé. |
| GET | /v1/public/payment-intents/{id}?client_secret= | clé publique | Statut public : id, status, amount, currency. |
| GET | /v1/payment-methods | payments:read | Fournisseurs ouverts pour votre compte et leurs capacités. |
Remboursements et versements
| Méthode | Chemin | Droit | Rôle |
|---|---|---|---|
| POST | /v1/refunds | refunds:write | Rembourser (total ou partiel). Idempotency-Key obligatoire. |
| GET | /v1/refunds · /v1/refunds/{id} | payments:read | Lister, lire. |
| POST | /v1/payouts | payouts:write | Verser vers un portefeuille. Idempotency-Key obligatoire. |
| GET | /v1/payouts · /v1/payouts/{id} | payouts:read | Lister (filtre status), lire. |
| POST | /v1/payouts/{id}/approve · /reject | tableau de bord | Approuver ou refuser : personne différente, double authentification récente. |
Solde, clients, rapports
| Méthode | Chemin | Droit | Rôle |
|---|---|---|---|
| GET | /v1/balance | balance:read | Soldes : pending, available, réserves. |
| GET | /v1/transactions | balance:read | Écritures comptables de vos comptes. |
| POST | /v1/customers | customers:write | Créer un client. |
| GET | /v1/customers · /v1/customers/{id} | customers:read | Lister, lire (téléphone masqué). |
| DELETE | /v1/customers/{id} | customers:write | Anonymiser (droit à l’effacement). |
| GET | /v1/dashboard/overview · revenue · fees | reports:read | Statistiques sur une période (from, to). |
| GET | /v1/dashboard/balance | balance:read | Soldes (comme /v1/balance). |
| GET | /v1/dashboard/reconciliation | reports:read | Écarts de rapprochement de votre compte. |
| GET | /v1/dashboard/payments | payments:read | Liste des paiements (mêmes filtres). |
| GET | /v1/reports/payments.csv | reports:read | Export CSV (from, to ; 10 000 lignes au plus). |
Compte et identité
| Méthode | Chemin | Droit | Rôle |
|---|---|---|---|
| GET | /v1/auth/me | toute clé | Qui appelle : type, marchand, permissions. |
| GET | /v1/merchant | tableau de bord | Profil du compte marchand. |
| PUT | /v1/merchant/webhook | tableau de bord | Configurer l’adresse du webhook (secret affiché une fois). |
| POST | /v1/merchant/webhook/rotate-secret | tableau de bord | Renouveler le secret de signature. |
| POST | /v1/merchant/kyb/submit | tableau de bord | Envoyer le dossier entreprise. |
| POST · GET · DELETE | /v1/api-keys | tableau de bord | Créer, lister, révoquer des clés API. |
Mode test uniquement
| Méthode | Chemin | Droit | Rôle |
|---|---|---|---|
| POST | /v1/sandbox/payments/{reference}/simulate | payments:write | Simuler le client : succeed, fail, expire. |
| POST | /v1/sandbox/payouts/{reference}/simulate | payouts:write | Simuler l’issue d’un versement : succeed, fail. |
Pas de Swagger public
La description OpenAPI de l’API n’est pas exposée publiquement en production. Cette documentation est la référence ; elle suit le code de l’API.