Aceptar pagos con OXXO

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).

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:

1. Agregar oxxo a la lista de payment_method_types
2. Asegúrate de que todos los line_items usen la moneda mxn.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'oxxo'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    oxxo: {
      expires_after_days: 2
    }
  },
  line_items: [{
    price_data: {
      # To accept `oxxo`, all line items must have currency: mxn
      currency: 'mxn',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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 diferida, tienes que usar un método como los webhooks para monitorear el estado del pago y gestionar el cumplimiento del pedido. Obtén más información sobre cómo configurar webhooks y completar pedidos.

Los siguientes eventos se envían cuando cambia el estado del pago:

Al probar tu integración de Checkout, selecciona OXXO como método de pago y haz click en el botón Pagar.