¿Cómo funciona OXXO Pay en tu ecommerce?
Te explico paso a paso cómo integrarlo y qué ocurre en cada fase del proceso para que tengas claro cómo funciona:
1. El cliente elige OXXO Pay como método de pago
En el checkout de tu tienda, el comprador selecciona “OXXO Pay” como forma de pago. Aparece la opción de pago en efectivo en tienda, sin necesidad de tarjeta.
2. Tu sistema genera una referencia única
Tras confirmar el pedido, tu ecommerce (vía plugin, API o SDK) crea una referencia alfanumérica de 14 a 16 dígitos, junto con su código de barras. Esa referencia es exclusiva para ese pedido.
3. El cliente recibe la orden de pago
Muestras al usuario la referencia y el código de barras, además de un plazo para pagar (normalmente 24–48 horas). El cliente puede descargarlo o imprimirlo y ver claramente el mensaje “Pagar en tienda OXXO”.
4. Pago en tienda OXXO
El comprador acude a cualquier tienda OXXO, presenta la referencia al cajero (o escanea el código de barras), y paga en efectivo o con tarjeta de débito/crédito (VISA o Mastercard).
5. OXXO confirma el pago
En cuanto se efectúa el pago, la red OXXO notifica al instante al backend de tu plataforma. Recibes esa confirmación por webhook (evento oxxopay.paid) y el estado del pedido cambia automáticamente a “pagado”.
6. Tu tienda completa la transacción
Con la notificación recibida, tu sistema puede:
- Enviar email al cliente confirmando el pago.
- Generar factura y adjuntarla.
- Poner en marcha la preparación y envío del pedido.
7. Si no se paga en plazo, se cancela
Si el comprador no realiza el pago dentro de las horas permitidas, la referencia expira y se cancela automáticamente. El pedido queda disponible nuevamente, sin afectar tu inventario.
¿Cómo funciona OXXO Pay en tu ecommerce?
Después de entender la esencia de OXXO Pay, entremos en detalle: este es el flujo operativo completo y actualizado para que tú lo domines y puedas explicarlo a tu cliente o implementarlo sin confusión.
1. Elige OXXO Pay al finalizar la compra
Tu tienda muestra esta opción como método de pago. El cliente selecciona “Pagar en tienda OXXO”, sin necesidad de tarjeta, ideal para quienes prefieren o sólo tienen efectivo.
2. Se genera una referencia única
Tu sistema crea automáticamente un código numérico de 14 a 16 dígitos, a veces con un código de barras asociado, junto con instrucciones claras:
- Tiempo para pagar (habitualmente 12–48 h)
- Número de referencia
- Si está activo, un link para compartirlo por correo o WhatsApp
3. El comprador recibe la referencia
Una vez generada, estableces un plazo visible (por ejemplo, 24 h) y envías al cliente:
- Correo o mensaje con el número
- PDF o imagen del código de barras
- Instrucciones precisas: “Muestra esto en cualquier tienda OXXO”
4. Pago en tienda física OXXO
El cliente puede acudir 24/7 a cualquier OXXO con:
- Su referencia numérica (dicen los 14-16 dígitos al cajero)
- O escanea el código de barras
Puede pagar en efectivo o con tarjeta VISA/Mastercard.
Tras el pago, el cliente obtiene un comprobante físico, que debe conservar.
5. Confirmación del pago
Gracias a la conectividad vía Conekta/FEMSA, tu ecommerce recibe una notificación por webhook en cuanto el cajero procesa el pago. El estado cambia automáticamente a “Pagado”.
Esto sucede en tiempo real o en pocos minutos, aunque en algunos escenarios puede tardar hasta 24 h, dependiendo del proveedor y sistema integrado.
6. Activación del pedido
Tu tienda reacciona automáticamente enviando:
- Email de confirmación de pago
- Factura o número de seguimiento
- Orden de preparación y envío
7. Si no se paga en plazo…
La referencia expira, y tu ecommerce la invalida al terminar su vigencia (12–48 h). El pedido se marca como “cancelado por expiración” y vuelve a estar disponible. Esto evita fidelización de stock con pagos no realizados.
Cómo integrar OXXO Pay en tu tienda online
Continuando con el recorrido, ahora te muestro el mejor paso a paso para integrar OXXO Pay en tu ecommerce. Lo dividiré en tres secciones: pasarelas compatibles, plataformas populares e implementación técnica. Así lo tendrás claro y funcional desde el primer momento.
🧩 1. Pasarelas compatibles
Estas son las principales opciones que ya incluyen soporte para OXXO Pay:
- Conekta: Ofrece pago en efectivo con OXXO + notificaciones en tiempo real vía webhook.
- Stripe: Su plugin en WooCommerce permite activar OXXO entre otros métodos locales.
- OpenPay y otros proveedores regionales en LATAM también incluyen esta opción.
La elección depende de tus necesidades técnicas, soporte y comisiones. Recomiendo analizar comisiones, soporte local o internacional y facilidad de uso.
⚙️ 2. Plataformas y sus plugins
Aquí te muestro cómo integrar OXXO Pay en las plataformas más usadas:
WooCommerce (WordPress)
- Instala y activa el plugin compatible (Conekta o WebToffee Stripe Gateway).
- Dirígete a WooCommerce → Ajustes → Pagos y activa OXXO.
- Configura el título, descripción, tiempos de expiración y añade tus API Keys de prueba o producción.
- Guarda cambios.
Shopify
- En el panel Shopify: Settings → Payments.
- Selecciona el proveedor como Conekta.
- Activa OXXO Pay y añade tus claves de producción.
- Pulsa “Guardar” para confirmar la integración.
Tiendanube
- Descarga e instala el plugin oficial de OXXO Pay/Conekta.
- Accede al panel de Tiendanube y añade las API Keys.
- Activa OXXO Pay, ajusta mensajes y tiempos de expiración.
🔌 3. Implementación técnica: referencias & webhooks
Independientemente de la plataforma, estos pasos son clave:
- Generación de referencias: Cada pedido crea una referencia única (14–16 dígitos + posible código de barras).
- Configura webhooks: En tu pasarela (Conekta/Stripe), establece una URL en tu web que reciba eventos como
oxxopay.paid,expired,cancelled. - Automatiza respuestas: Cuando recibas la confirmación:
- Marca el pedido como pagado.
- Envía email de confirmación al cliente y empieza con la preparación/envío.
En WooCommerce con Conekta, estas URLs suelen ser automáticas como:https://tusitio.com/wc-api/WC_Conekta_Cash_Gateway (o la URL unificada moderna). Asegúrate de que respondan correctamente, que usen HTTPS y que los eventos estén activos.
✅ Checklist rápido de integración
| Tarea | WooCommerce | Shopify | Tiendanube |
|---|---|---|---|
| Plugin instalado | ✔️ Conekta o WebToffee | ✔️ Conekta App | ✔️ Plugin oficial |
| API Keys configuradas | ✔️ Sí | ✔️ Sí | ✔️ Sí |
| OXXO Pay activado | ✔️ Sí | ✔️ Sí | ✔️ Sí |
| Webhook configurado | ✔️ En panel WooCommerce / Conekta | ✔️ En panel Shopify | ✔️ Incluido en plugin |
| Probar en modo test | ✔️ Sí | — | — |
| Ir a producción | ✔️ Relaiva live | ✔️ Guardar y live | ✔️ Activado |
💡 Tips para una integración exitosa
- Prueba antes de ir a producción: Siempre realiza pedidos de prueba tanto en test como en vivo.
- Comunicación clara al cliente: Asegúrate de explicar el proceso de pago, ubicación de tiendas OXXO y tiempos de expiración.
- Monitoriza tu webhook: Verifica que la tienda esté recibiendo los eventos correctamente.
- Soporte local: Considera escoger pasarelas con buen soporte en México si tu público principal está allí.
