Customer Portal

Le Customer Portal est l’équivalent SahelPay du Stripe Customer Portal. Il permet à vos clients de gérer leur compte, consulter leur historique de transactions et gérer leurs abonnements, sans que vous ayez à développer cette interface.

Concept

┌─────────────────┐      POST /v1/portal/sessions      ┌─────────────────┐
│   Votre Site    │ ─────────────────────────────────► │    SahelPay     │
│   (Backend)     │ ◄───────────────────────────────── │      API        │
└─────────────────┘      { url: "https://..." }        └─────────────────┘
        │                                                      │
        │ Redirect client                                      │
        ▼                                                      ▼
┌─────────────────┐                                   ┌─────────────────┐
│   Votre Client  │ ─────────────────────────────────►│ Customer Portal │
│                 │      Accède à son espace          │   SahelPay      │
└─────────────────┘                                   └─────────────────┘

Fonctionnalités

Fonctionnalité	Description
Profil	Voir et modifier nom, email
Transactions	Historique complet des paiements
Reçus PDF	Télécharger un reçu pour chaque transaction réussie
Abonnements	Voir et annuler les abonnements actifs
Méthodes de paiement	Gérer les numéros Mobile Money enregistrés
Statistiques	Total dépensé, nombre de transactions

Créer une session

Depuis votre backend, créez une session pour votre client :

const session = await sahelpay.portal.createSession({
  customer_phone: '+22370123456',
  customer_name: 'Moussa Diarra',
  customer_email: 'moussa@example.com',
  return_url: 'https://votresite.com/account'
});

// Rediriger le client
window.location.href = session.url;

session = client.portal.create_session(
    customer_phone='+22370123456',
    customer_name='Moussa Diarra',
    customer_email='moussa@example.com',
    return_url='https://votresite.com/account'
)

# Rediriger le client
redirect(session['url'])

$session = $sahelpay->portal->createSession([
    'customer_phone' => '+22370123456',
    'customer_name' => 'Moussa Diarra',
    'customer_email' => 'moussa@example.com',
    'return_url' => 'https://votresite.com/account'
]);

// Rediriger le client
header('Location: ' . $session->url);

Réponse

{
  "success": true,
  "data": {
    "id": "portal_session_abc123",
    "url": "https://pay.sahelpay.ml/portal/portal_xyz789...",
    "customer_id": "cus_def456",
    "expires_at": "2025-01-02T12:00:00.000Z"
  }
}

Exemple complet (Express.js)

app.get("/mon-compte", async (req, res) => {
  // Récupérer les infos du client depuis votre DB
  const user = await db.users.findById(req.user.id);
  
  // Créer une session portal
  const session = await sahelpay.portal.createSession({
    customer_phone: user.phone,
    customer_name: user.name,
    customer_email: user.email,
    return_url: `${APP_URL}/account`
  });
  
  // Rediriger vers le portal
  res.redirect(session.url);
});

Expiration

Les sessions expirent après 24 heures. Si un client clique sur un lien expiré, proposez-lui d’en générer un nouveau.

Ce que le client voit

Une fois redirigé vers le portal, le client peut :

Voir son profil : Nom, email, téléphone
Consulter ses transactions : Historique complet avec filtres
Télécharger des reçus : PDF pour chaque transaction réussie
Gérer ses abonnements : Voir les plans actifs et annuler si besoin
Gérer ses méthodes de paiement : Ajouter/supprimer des numéros Mobile Money
Voir ses statistiques : Total dépensé, nombre de transactions

Retour sur votre site

Quand le client clique sur “Retour” dans le portal, il est redirigé vers votre return_url :

// https://votresite.com/account?portal_session=xxx
app.get("/account", (req, res) => {
  if (req.query.portal_session) {
    // Le client revient du portal
    res.render("account", { message: "Modifications sauvegardées" });
  } else {
    res.render("account");
  }
});

Cas d’usage

SaaS - Gestion d’abonnements

// Bouton "Gérer mon abonnement" sur votre dashboard
app.get("/billing/manage", async (req, res) => {
  const session = await sahelpay.portal.createSession({
    customer_phone: req.user.phone,
    return_url: `${APP_URL}/billing`
  });
  
  res.redirect(session.url);
});

E-commerce - Historique de commandes

// Bouton "Mes commandes" 
app.get("/orders", async (req, res) => {
  const session = await sahelpay.portal.createSession({
    customer_phone: req.user.phone,
    return_url: `${APP_URL}/orders`
  });
  
  res.redirect(session.url);
});

Bonnes pratiques

Toujours utiliser HTTPS pour le return_url
Stocker le customer_id retourné pour référence future
Gérer l’expiration : proposez de régénérer une session si expirée
Pré-remplir les infos : passez customer_name et customer_email pour une meilleure UX
Sécuriser l’accès : vérifiez que l’utilisateur est authentifié avant de créer une session

Le Customer Portal est hébergé par SahelPay. Vous n’avez pas besoin de développer cette interface - créez simplement une session et redirigez le client.

Getting Started

Guides

Resources

Customer Portal

Customer Portal

Concept

Fonctionnalités

Créer une session

Réponse

Exemple complet (Express.js)

Expiration

Ce que le client voit

Retour sur votre site

Cas d’usage

SaaS - Gestion d’abonnements

E-commerce - Historique de commandes

Bonnes pratiques

​Customer Portal

​Concept

​Fonctionnalités

​Créer une session

​Réponse

​Exemple complet (Express.js)

​Expiration

​Ce que le client voit

​Retour sur votre site

​Cas d’usage

​SaaS - Gestion d’abonnements

​E-commerce - Historique de commandes

​Bonnes pratiques

Customer Portal

Concept

Fonctionnalités

Créer une session

Réponse

Exemple complet (Express.js)

Expiration

Ce que le client voit

Retour sur votre site

Cas d’usage

SaaS - Gestion d’abonnements

E-commerce - Historique de commandes

Bonnes pratiques