Skip to main content
Este tutorial crea una sesión de Hosted Checkout con un monto manual. Tu backend recibe una URL y la envía al frontend.

Reúne los requisitos

Necesitas:
  • Una cuenta de SimplePay
  • Un comercio con ambiente sandbox activo
  • Una llave con hosted_checkout:write
  • Un backend que proteja la llave
Nunca incluyas una llave de SimplePay en JavaScript del navegador, una app móvil o un repositorio.

Configura la terminal

Define el host sandbox. Lee la llave sin guardarla en tu historial:

Crea la sesión

Envía el monto en la unidad menor de la moneda. 50000 representa MXN 500.00:
La respuesta contiene id, public_reference y url. Guarda id para lecturas autenticadas y usa url para la redirección.

Redirige al comprador

Tu backend devuelve sólo la URL pública al frontend:

Confirma el resultado

El navegador no confirma un pago. Actualiza tu orden cuando recibas payment.succeeded o una lectura autenticada equivalente.

Configura webhooks

Verifica firmas y procesa eventos sin duplicar efectos.
Última modificación el 22 de agosto de 2026