Aceptar un pago
Crea un formulario de pago o usa una página de confirmación de compra prediseñada para comenzar a aceptar pagos electrónicos.
Redirige a los usuarios a una página de pago alojada en Stripe 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
Redirigir a la página de pagos alojada en Stripe
Personalización de la interfaz de usuario
Configura StripeLado del servidor
Primero, inscríbete para obtener una cuenta de Stripe.
Usa nuestras bibliotecas oficiales para acceder a la API de Stripe desde tu aplicación:
Redirige a tu cliente a Stripe CheckoutLado del clienteLado del servidor
Agrega un botón para finalizar la compra en tu sitio web que llame a un punto de conexión del lado del servidor para crear una sesión de Checkout.
<html> <head> <title>Buy cool new product</title> </head> <body> <!-- Use action="/create-checkout-session.php" if your server is PHP based. --> <form action="/create-checkout-session" method="POST"> <button type="submit">Checkout</button> </form> </body> </html>
Una sesión de Checkout es la representación programática de lo que ve tu cliente cuando es redirigido al formulario de pago. Puedes configurarla con opciones como estas:
- Partidas por cobrar
- Monedas que se utilizarán
You also need to specify success_url
, a page on your website that Checkout returns your customer to after they complete the payment. You can optionally provide cancel_url
, a page on your website that Checkout returns your customer to if they cancel the payment process.
Nota
Las sesiones de Checkout vencen 24 horas después de ser creadas
Después de crear una sesión de Checkout, debes redirigir a tu cliente a la URL que se devuelve en la respuesta.
Nota
De forma predeterminada, Stripe habilita las tarjetas y otros métodos de pagos comunes que pueden ayudarte a captar más clientes. Puedes habilitar o deshabilitar los métodos de pago en el Dashboard de Stripe. Para determinar la lista de métodos de pago que se mostrará en Checkout, Stripe evalúa la moneda, las restricciones de los métodos de pago y otros parámetros.
Test your endpoint by starting your web server (for example, localhost:4242
) and running the following command:
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""
Debes ver una respuesta en tu terminal parecida a esta:
HTTP/1.1 303 See Other Location: https://checkout.stripe.com/c/pay/cs_test_... ...
Pruebas
Ya deberías tener un botón de pago en funcionamiento para redirigir al cliente a Stripe Checkout.
- Haz click en el botón de pago.
- Serás redirigido al formulario de pago de Stripe Checkout.
Si tu integración no funciona:
- Abre la pestaña Red en las herramientas de desarrollador de tu navegador.
- Click the checkout button and confirm it sent an XHR request to your server-side endpoint (
POST /create-checkout-session
). - Verifica que la solicitud devuelva un código de estado 200.
- Use
console.log(session)
inside your button click listener to confirm the correct data returned.
Para ver cómo se muestran tus métodos de pago a los clientes, introduce un ID de transacción o establece el importe y la moneda de un pedido en el Dashboard.
Mostrar página de confirmaciónLado del clienteLado del servidor
Es importante que tu cliente vea una página de confirmación después de haber enviado correctamente el formulario de pago. Aloja esta página en tu sitio.
Crea una página de confirmación mínima:
<html> <head><title>Thanks for your order!</title></head> <body> <h1>Thanks for your order!</h1> <p> We appreciate your business! If you have any questions, please email <a href="mailto:orders@example.com">orders@example.com</a>. </p> </body> </html>
Luego, actualiza el punto de conexión de creación de la sesión de Checkout para usar esta nueva página:
Nota
Si quieres personalizar tu página de confirmación, lee la guía para personalizar la página de confirmación.
Pruebas
- Haz clic en el botón de finalización de compra.
- Completa los datos de pago con la información de la tarjeta de prueba:
- Ingresa
4242 4242 4242 4242
como número de tarjeta. - 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.
- Ingresa
- Haz click en Pagar.
- Serás redirigido a tu nueva página de confirmación.
A continuación, busca el nuevo pago en el Dashboard de Stripe. Los pagos exitosos aparecen en la lista de pagos del Dashboard . Cuando haces clic en un pago, se te dirige a la página de información del pago. La sección Resumen de la compra contiene información de facturación y la lista de artículos comprados, que puedes usar para completar el pedido manualmente.
Prueba tu integración
Para probar la integración de tu formulario de pago alojado en Stripe:
- Crea una sesión de Checkout.
- 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. Serás redirigido a tu
success_url
. - Ve al Dashboard y busca el pago en la página Pagos. Si tu pago se efectuó correctamente, lo verás en esa lista.
- Haz clic en tu pago para ver más detalles, como un resumen de Checkout 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.
Tarjetas de prueba
Número | Descripción |
---|---|
Se efectúa correctamente la transacción y se procesa el pago de inmediato. | |
Para que el pago se efectúe correctamente, se requiere la autenticación con 3D Secure 2. | |
Siempre da error con un código de rechazo insufficient_funds . |
Apple Pay y Google Pay
Puedes habilitar Apple Pay y Google Pay en tu configuración de métodos de pago. Apple Pay está habilitado de forma predeterminada.
Las páginas alojadas en Stripe de Checkout no necesitan cambios de integración para habilitar Apple Pay o Google Pay. Stripe gestiona estos pagos igual que otros pagos con tarjeta.
Ahora que ya tienes una integración básica, aprende a programar la recepción de una notificación cada vez que un cliente paga.