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 confirmar 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
Debes compeltar success_url
con el valor de la URL de una página en tu sitio web a la que Checkout redirige al cliente después de que efectúa el pago. Opcionalmente, también puedes proporcionar un valor cancel_url
de una página en tu sitio web a la que Checkout redirige al cliente si finaliza el proceso de pago antes de que se complete.
Nota
Las sesiones de Checkout vencen 24 horas después de su creación.
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 pago habituales que pueden ayudarte a llegar a más clientes. Puedes activar o desactivar los métodos de pago en el Dashboard de Stripe. Stripe evalúa la moneda y las restricciones de los métodos de pago y, a continuación, muestra dinámicamente el conjunto de métodos de pago admitidos en Checkout.
Confirma que tu punto de conexión es accesible iniciando tu servidor web (por ejemplo, localhost:4242
) y ejecutando el siguiente comando:
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 confirmación de compra para redirigir al cliente a Stripe Checkout.
- Haz clic en el botón de confirmación de compra.
- 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.
- Haz click en el botón de confirmación de compra y confirma que se le haya enviado una solicitud XHR a tu punto de conexión de lado del servidor (
POST /create-checkout-session
). - Verifica que la solicitud devuelva un código de estado 200.
- Usa
console.log(session)
dentro del oyente de click del botón para confirmar que se devolvieron los datos correctos.
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.