DolaPay Developers

Checkout Sessions

La méthode de paiement la plus simple et sécurisée. Redirigez votre client vers la page de paiement hébergée par DolaPay. Parfait pour les sites E-commerce.

Comment ça marche ?

Création (API)

Faites un appel API POST depuis votre backend sécurisé pour créer une session avec le montant de la commande.

Redirection (Client)

L'API vous renvoie une URL unique (data.url). Redirigez le navigateur de votre client vers ce lien. DolaPay s'occupe de la page de paiement.

Confirmation (Webhook)

Le client paie. Il est redirigé vers votre success_url. Vous recevez un webhook sécurisé pour valider la commande dans votre base.

Créer une Checkout Session

POST/api/v1/checkout/sessions

Paramètres du Body (JSON)

Paramètre	Description
amount *	Le montant à facturer au client (ex: `5000`). Toujours en entier (sans décimales). Minimum 100 FCFA.
currency *	La devise de la transaction. Actuellement, seul `XOF` est supporté pour l'UEMOA.
success_url *	L'URL où rediriger le client après un paiement réussi. Vous pouvez inclure `{CHECKOUT_SESSION_ID}` dans l'URL ; DolaPay le remplacera par le vrai ID.
cancel_url *	L'URL où rediriger le client s'il clique sur "Annuler" sur la page de paiement.
client_reference_id	Une référence unique de votre système (ex: ID de Commande). Ce champ vous sera renvoyé tel quel dans les webhooks pour faire la correspondance.
customer_email	L'email du client, utilisé pour préremplir le formulaire ou envoyer un reçu (Optionnel).

javascript

const response = await fetch("https://api.dola-pay.com/v1/checkout/sessions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_votre_cle_secrete",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    amount: 5000,
    currency: "XOF",
    success_url: "https://votre-site.com/success?session_id={CHECKOUT_SESSION_ID}",
    cancel_url: "https://votre-site.com/cancel",
    client_reference_id: "CMD-10293",
    customer_name: "Jean Dupont",
    customer_email: "jean.dupont@email.com"
  })
});
const { data } = await response.json();
console.log(data.url); // Redirigez l'utilisateur vers cette URL pour payer