Redirection Checkout

Le mode Redirection est l’intégration la plus simple : créez une Session de paiement côté serveur, puis redirigez l’acheteur vers l’URL de session Sangho. Sangho gère toute la page de paiement.

Flux complet

1. Serveur : Créer une Session de paiement avec success_url, currency et line_items
2. Serveur : Retourner l’URL de session au client
3. Client : Rediriger vers session.url
4. Acheteur : Payer sur la page Sangho
5. Sangho : Rediriger vers success_url après paiement
6. Serveur : Écouter l’événement checkout.session.completed via webhook

Avantages

Aucun code frontend complexe
Page de paiement responsive et sécurisée maintenue par Sangho
Support automatique de toutes les méthodes de paiement activées
3D Secure géré automatiquement pour les cartes
Conforme PCI-DSS sans effort

Note

Le mode Redirection est recommandé pour la majorité des intégrations e-commerce. Utilisez le mode Embedded uniquement si vous avez besoin d’un contrôle total sur l’UX.

Créer et rediriger

bash

curl -X POST https://api.sangho.com/v1/checkout-sessions/ \
  -H "Authorization: Bearer sk_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "success_url": "https://boutique.com/merci",
    "cancel_url": "https://boutique.com/panier",
    "currency": "XAF",
    "line_items": [{"product": "prod_xxx", "quantity": 1}],
    "metadata": {"order_id": "CMD-001"}
  }'