Checkout con redirección

El modo de redirección es la integración más sencilla: cree una Sesión de pago en el servidor y redirija después al comprador a la URL de sesión de Sangho. Sangho gestiona toda la página de pago.

Flujo completo

1. Servidor: crear una Sesión de pago con success_url, currency y line_items
2. Servidor: devolver la URL de sesión al cliente
3. Cliente: redirigir a session.url
4. Comprador: pagar en la página de Sangho
5. Sangho: redirigir a success_url tras el pago
6. Servidor: escuchar el evento checkout.session.completed mediante webhook

Ventajas

Sin código frontend complejo
Página de pago responsive y segura, mantenida por Sangho
Compatibilidad automática con todos los métodos de pago activados
3D Secure gestionado automáticamente para las tarjetas
Cumplimiento de PCI-DSS sin esfuerzo

Note

El modo de redirección se recomienda para la mayoría de las integraciones de comercio electrónico. Utilice el modo Embedded solo si necesita un control total sobre la UX.

Crear y redirigir

bash

curl -X POST https://api.sangho.ga/v1/checkout-sessions/ \
  -H "Authorization: Bearer sk_prod_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"}
  }'