Demarrage rapide

Ce guide vous accompagne de l’authentification jusqu’au suivi d’une premiere transaction.

1. Preparez vos domaines

Toutes les requetes de paiement partent vers la gateway.

https://api.mysoleas.com

Toutes les requetes OAuth partent vers le service d’authentification.

https://account.mysoleas.com

Stockez ces URLs dans des variables d’environnement. Cela rend vos tests, vos workers et votre backoffice plus faciles a maintenir.

2. Obtenez un access token

Pour une integration serveur a serveur, utilisez le grant client_credentials.

curl -X POST "https://account.mysoleas.com/oauth/v2/token" \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "scope": "payments services countries providers"
  }'

La reponse contient un access_token.

{
  "token_type": "Bearer",
  "expires_in": 3600,
  "access_token": "eyJ..."
}

3. Appelez la gateway

Transmettez le jeton dans Authorization.

curl "https://api.mysoleas.com/service/list?country=CM&currency=XAF" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

Vous pouvez aussi transmettre des headers de contexte lorsque votre application gere plusieurs environnements ou pays.

Header	Usage
`Authorization`	Jeton Bearer obligatoire
`X-Request-Id`	Identifiant de trace cote marchand
`X-Idempotency-Key`	Cle d’idempotence explicite pour les operations sensibles
`X-SP-Country`	Pays actif, par exemple `CM`
`X-SP-Environment`	Environnement logique, par exemple `prod` ou `dev`

4. Choisissez un service

Listez les services disponibles avant de creer une transaction. Le champ code du service devient la valeur provider dans les payloads de paiement.

curl "https://api.mysoleas.com/service/list?country=CM&currency=XAF" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Un service utilisable pour une collection doit avoir is_active: true et is_can_collect: true. Un service utilisable pour un disbursement doit avoir is_active: true et is_can_disburse: true.

5. Lancez une collection

Le flux standard se fait en trois appels: intent, execute, puis status.

curl -X POST "https://api.mysoleas.com/collection/intent" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2500,
    "currency": "XAF",
    "transaction_uuid": "2f8b9a68-1ad3-4a0c-a187-40b91a4c44a1",
    "provider": "CM_MTN_MOMO",
    "channel": "PROVIDER",
    "customer_wallet": "237670000000",
    "description": "Commande MS-10045"
  }'

La reponse contient transaction_reference. Utilisez cette valeur pour executer et suivre la transaction.

curl -X POST "https://api.mysoleas.com/collection/execute" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_reference": "TRX-20260728-000001",
    "invoice_reference": "MS-10045"
  }'

6. Suivez le statut

Interrogez le statut jusqu’a obtenir un etat final.

curl -X POST "https://api.mysoleas.com/collection/status" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_reference": "TRX-20260728-000001"
  }'

Les etats finaux sont COMPLETED, SUCCESS, FAILED, CANCELLED et REFUNDED.

Demarrer

Paiements

Catalogue

1. Preparez vos domaines

2. Obtenez un access token

3. Appelez la gateway

4. Choisissez un service

5. Lancez une collection

6. Suivez le statut

​1. Preparez vos domaines

​2. Obtenez un access token

​3. Appelez la gateway

​4. Choisissez un service

​5. Lancez une collection

​6. Suivez le statut

1. Preparez vos domaines

2. Obtenez un access token

3. Appelez la gateway

4. Choisissez un service

5. Lancez une collection

6. Suivez le statut