Aceptar pagos con OXXO
Precaución
Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
Si quieres seguir configurando manualmente los métodos de pago que tus clientes verán en Checkout, usa esta guía (por ejemplo, para aceptar pagos en modo suscripción). De lo contrario, migra al Dashboard.
OXXO es un método de pago de uso único que solicita a los clientes cumplir con pasos adicionales para completar su pago. Los clientes pagan presentando el vale OXXO con un número generado y el pago en efectivo en una tienda de 24 horas OXXO.
Determinar compatibilidad
La sesión de Checkout debe cumplir con todas estas condiciones para aceptar pagos con OXXO:
- Los precios de todos los ítems de factura deben estar expresados en la misma moneda. Si tienes ítems en otras monedas, crea sesiones de Checkout separadas para cada moneda.
- Solo puedes utilizar ítems de partida puntuales (no se aceptan planes de suscripción recurrentes).
Aceptar un pago
Nota
Crea una integración para aceptar un pago con Checkout antes de usar esta guía.
Utiliza esta guía para aprender a activar OXXO. Muestra las diferencias entre aceptar un pago con tarjeta y usar OXXO.
Habilitar OXXO como método de pago
Al crear una nueva sesión de Checkout, debes:
- Agregar
oxxo
a la lista depayment_method_types
- Asegúrate de que todos los
line_items
usen la monedamxn
.
Opciones de métodos de pago adicionales
Puedes especificar un parámetro opcional expires_after_days
en las opciones de métodos de pago de tu Session
que define la cantidad de días calendario que deben pasar para que venza el vale OXXO. Por ejemplo, si creas un vale OXXO un lunes y defines expires_after_days
en 2, el vale OXXO vencerá el miércoles a las 23:59, zona horaria de America/Mexico_City (UTC-6). El parámetro expires_after_days
puede ser de 1 a 7 días. El valor predeterminado es 3 días.
Redireccionamiento a la página del vale alojada por Stripe
Después de enviar el formulario de Checkout correctamente, se redirige al cliente a la hosted_voucher_url
. El cliente puede buscar el código de barras o imprimir el vale OXXO desde la página de vales alojada. Puedes localizar la hosted_voucher_url
en payment_intent.next_action.oxxo_display_details.
Stripe permite la personalización de las interfaces de usuario del cliente en la página configuración de imagen de marca. Se puede aplicar la siguiente configuración de imagen de marca al vale:
- Ícono: tu imagen de marca y el nombre público de la empresa
- **Color de acento **: se usa como el color del botón Imprimir
- Color de la marca: se utiliza como color de fondo
Completa los pedidos
Debido a que OXXO es un método de pago con notificación demorada, tienes que usar un método como los webhooks para monitorear el estado del pago y gestionar el cumplimiento del pedido. Más información sobre cómo configurar webhooks y completar pedidos.
Los siguientes eventos se envían cuando cambia el estado del pago:
Nombre del evento | Descripción | Próximos pasos |
---|---|---|
El cliente ha enviado correctamente el formulario de Checkout. Stripe ha generado el vale OXXO. Puedes elegir enviar la | Espera a que el cliente pague el vale OXXO. | |
checkout.session.async_payment_succeeded | El cliente ha pagado correctamente el vale OXXO. El PaymentIntent pasa a succeeded . | Entrega los bienes o servicios que el cliente compró. |
checkout.session.async_payment_failed | El vale OXXO ha caducado o el pago ha fallado por algún otro motivo. El estado del PaymentIntent vuelve a ser requires_payment_method . | Ponte en contacto con el cliente por correo electrónico y solicítale que haga un nuevo pedido. |
Prueba tu integración
Al probar tu integración de Checkout, selecciona OXXO como método de pago y haz click en el botón Pagar.
Correo electrónico | Descripción |
---|---|
| Simula un vale OXXO abonado por el cliente al cabo de 3 minutos con el webhook Ejemplo: fulano@test.com |
| Simula un vale OXXO abonado por el cliente de inmediato con el webhook Ejemplo: succeed_immediately@test.com |
| Simula un vale OXXO que venza antes de que pague el cliente con el webhook El campo Ejemplo: expire_immediately@test.com |
| Simula un vale OXXO que venza antes de que pague el cliente con el webhook El campo Ejemplo: expire_with_delay@test.com |
| Simula un vale OXXO que venza antes de que pague el cliente con el webhook Ejemplo: fill_never@test.com |