Aceptar un pago
Acepta pagos en línea en modo seguro.
Crea un formulario de pago o usa una página de confirmación de compra prediseñada para comenzar a aceptar pagos electrónicos.
Integra un formulario de pago prediseñado en tu sitio con Stripe Checkout. Comprueba cómo esta integración se compara con los otros tipos de integración de Stripe.


Esfuerzo de integración
Tipo de integración
Integra un formulario de pago prediseñado en tu sitio
Personalización de la interfaz de usuario
Usa la configuración de imagen de marca en el Dashboard de Stripe para que el Checkout coincida con el diseño de tu sitio.
Primero, inscríbete para obtener una cuenta de Stripe.
Usa nuestras bibliotecas oficiales para acceder a la API de Stripe desde tu aplicación:
Crear una sesión de CheckoutLado del servidor
Desde tu servidor, crea una sesión de Checkout y establece el ui_mode en embedded
. Puedes configurar la sesión de Checkout con partidas que se incluyan y opciones como la moneda.
También puedes crear una Checkout Session para un cliente existente, lo que te permite completar previamente los campos de Checkout con información de contacto conocida y unificar tu historial de compras para ese cliente.
Para que los clientes regresen a una página personalizada que alojas en tu sitio web, especifica la URL de esa página en el parámetro return_url. Incluye la variable de plantilla {CHECKOUT_
en la URL para recuperar el estado de la sesión en la página de retorno. Checkout sustituye automáticamente la variable con la ID de la sesión de Checkout antes de redirigir al usuario.
Obtén más información sobre cómo configurar la página de retorno y otras opciones para personalizar el comportamiento de redireccionamiento.
Después de crear la sesión de Checkout, usa el código client_
que se devolvió en la respuesta para montar Checkout.
Incorporar CheckoutLado del cliente
Checkout se representa en un iframe que envía la información del pago a Stripe en modo seguro a través de una conexión HTTPS.
Errores habituales
Evita colocar Checkout en otro iframe, ya que algunos métodos de pago requieren un redireccionamiento a otra página para confirmar el pago.
Personaliza el aspecto
Para personalizar Checkout y que coincida con el diseño de tu sitio, establece el color de fondo, el color del botón, el radio del borde y las fuentes en la configuración de marca de tu cuenta.
De forma predeterminada, Checkout procesa sin relleno o margen externos. Te recomendamos usar un elemento contenedor como un div para aplicar el margen deseado (por ejemplo, 16 px en todos los lados).
Mostrar página de devolución
Luego de que el cliente intente realizar el pago, Stripe lo redirige a una página de retorno que alojas en tu sitio. Cuando creaste la sesión de Checkout, especificaste la URL de la página de retorno en el parámetro return_url. Obtén más información sobre otras opciones para personalizar el comportamiento de redireccionamiento.
Cuando muestres tu página de retorno, recupera el estado de la sesión de Checkout con el ID de sesión de Checkout en la URL. Gestiona el resultado de acuerdo con el estado de la sesión de la siguiente manera:
complete
: el pago se efectuó correctamente. Usa la información de la sesión de Checkout para mostrar una página que indique que el pago se realizó correctamente.open
: el pago falló o se canceló. Vuelve a montar Checkout para que tu cliente pueda volver a intentarlo.
const session = await fetch(`/session_status?session_id=${session_id}`) if (session.status == 'open') { // Remount embedded Checkout } else if (session.status == 'complete') { // Show success page // Optionally use session.payment_status or session.customer_email // to customize the success page }
Métodos de pago basados en redirecciones
Durante el proceso de pago, algunos métodos de pago redirigen al cliente a una página intermedia, como una página de autorización bancaria. Cuando completan esa página, Stripe los redirige a tu página de retorno.
Obtén más información sobre métodos de pago que requieren redireccionamientos y comportamiento de redireccionamiento.
Administra eventos posteriores al pago
Stripe envía un evento checkout.session.completed cuando un cliente completa un pago de la Checkout Session. Usa la herramienta de webhooks del Dashboard o sigue la guía de webhooks para recibir y gestionar estos eventos, que podrían hacer que hagas lo siguiente:
- Envía un correo electrónico de confirmación del pedido a tu cliente.
- Registra la venta en una base de datos.
- Inicia el flujo de tareas de envío.
Recibe notificaciones de estos eventos en lugar de esperar a que se redirija a tu cliente de nuevo a tu sitio web. Activar el cumplimiento del pedido solo desde la página de inicio de Checkout no es confiable. Si configuras tu integración para recibir notificaciones de eventos asincrónicos, podrás aceptar diferentes tipos de métodos de pago con una sola integración.
Obtén más información en nuestra guía de gestión logística para Checkout.
Gestiona los siguientes eventos al cobrar pagos con Checkout:
Evento | Descripción | Acción |
---|---|---|
checkout.session.completed | Se envía cuando un cliente completa correctamente una Checkout Session. | Envía al cliente una confirmación del pedido y completa el pedido. |
checkout.session.async_payment_succeeded | Se envía cuando un pago realizado con un método de pago retrasado, como el débito directo ACH, se efectúa correctamente. | Envía al cliente una confirmación del pedido y completa el pedido. |
checkout.session.async_payment_failed | Se envía cuando falla un pago realizado con un método de pago retrasado, como el débito directo ACH. | Notifica al cliente el error y regrésalo a la sesión para que vuelva a intentar el pago. |
Prueba tu integración
Para probar la integración de tu formulario de pago integrado:
- Crea una sesión de Checkout incrustada e incorpora Checkout en tu página.
- Completa los datos del pago con un método de la siguiente tabla.
- Ingresa una fecha futura como fecha de vencimiento.
- Ingresa cualquier número de 3 dígitos como CVC.
- Ingresa un código postal de facturación.
- Haz clic en Pagar. Te redirigiremos a tu
return_
.url - Ve al Dashboard y busca el pago en la página Transacciones. Si tu pago se realizó correctamente, lo verás en esa lista.
- Haz clic en tu pago para ver más detalles, como un resumen de pago con la información de facturación y la lista de artículos comprados. Puedes usar esta información para completar el pedido.
Obtén más información sobre cómo probar tu integración.
Consulta Pruebas para obtener información adicional para probar tu integración.