Crea sesiones de Hosted Checkout

Hosted Checkout mantiene la captura sensible fuera de tu aplicación. Tu backend crea una sesión y recibe la URL pública de SimplePay.

Elige el origen del monto

Envía exactamente una opción:

manual_amount: monto en la unidad menor de la moneda
catalog_line_item: snapshot generado desde Digital Catalog

No envíes ambos campos.

Crea una sesión

curl -sS -X POST "$SIMPLEPAY_API_BASE/v1/hosted-checkout/sessions" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_2001_checkout_v1" \
  --data '{
    "manual_amount": 149900,
    "currency": "mxn",
    "payment_method_types": ["card", "spei", "oxxo"],
    "metadata": {"order_id": "order_2001"}
  }'

Guarda id, public_reference, url, monto, moneda y tu referencia de orden.

Confirma el resultado

El redirect es una señal de experiencia, no una confirmación financiera. Procesa el webhook o consulta la sesión desde tu backend.

Consulta la referencia de Checkout

Revisa los schemas de creación, listado y lectura.

Última modificación el 22 de agosto de 2026

Empezar

Fundamentos

Aceptar pagos

Catálogo

Webhooks

Plataforma

Agentes

Crea sesiones de Hosted Checkout

Elige el origen del monto

Crea una sesión

Confirma el resultado

Consulta la referencia de Checkout

​Elige el origen del monto

​Crea una sesión

​Confirma el resultado

Consulta la referencia de Checkout

Elige el origen del monto

Crea una sesión

Confirma el resultado