Skip to main content
POST
/
v1
/
portal
/
sessions
Créer une session portal
curl --request POST \
  --url https://api.example.com/v1/portal/sessions

Documentation Index

Fetch the complete documentation index at: https://docs.sahelpay.ml/llms.txt

Use this file to discover all available pages before exploring further.

​
Créer une session Customer Portal

Crée une session pour permettre à un client d’accéder à son portail self-service.

​
Endpoint

POST /v1/portal/sessions

​
Headers

HeaderRequisDescription
Authorization✅Bearer sk_xxx
Content-Type✅application/json

​
Body

ParamètreTypeRequisDescription
customer_phonestring✅Numéro de téléphone du client (+223…)
customer_namestringNom du client
customer_emailstringEmail du client
return_urlstringURL de retour après utilisation du portal

​
Exemple

curl -X POST https://api.sahelpay.ml/v1/portal/sessions \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_phone": "+22370123456",
    "customer_name": "Moussa Diarra",
    "customer_email": "moussa@example.com",
    "return_url": "https://votresite.com/account"
  }'

​
Réponse

{
  "success": true,
  "data": {
    "id": "portal_session_abc123",
    "url": "https://pay.sahelpay.ml/portal/portal_xyz789...",
    "customer_id": "cus_def456",
    "expires_at": "2025-12-19T16:45:00.000Z"
  }
}

​
Redirection

Redirigez le client vers l’URL retournée : 
window.location.href = session.url;

​
Expiration

Les sessions expirent après 24 heures. Si un client clique sur un lien expiré, créez une nouvelle session.

​
Erreurs

CodeDescription
INVALID_PHONENuméro de téléphone invalide
MISSING_RETURN_URLURL de retour requise
Le Customer Portal est hébergé par SahelPay. Vous n’avez qu’à créer une session et rediriger le client vers l’URL retournée.