Paso 1

Añade tu llave privada y versión del API.

Necesitas tu llave privada de pruebas. Puedes encontrarla en tu admin.

Paso 2

Crea una orden

Al crear un order se generará el cargo de tu cliente. Si no deseas crear el cargo inmediato, puedes preparar la orden y después generar el cargo mandando la información del arreglo charges.

Los campos mostrados en el ejemplo son los mínimos requeridos, si deseas saber más sobre el objeto order revisa nuestra REST API.

Si deseas que tu ficha expire puedes añadir el atributo expires_at dentro de payment_method, es un campo tipo unix timestamp que te permite generar una ficha que expire ¡hasta por segundos!

Paso 3

Procesar respuesta

Una vez creada la orden y el cargo, deberás procesar la respuesta y presentar la ficha de pago.

Recuerda que la respuesta de una orden es formato JSON.

Paso 4

Presentar ficha de pago

Utiliza una ficha como esta para darle a tu cliente la referencia de pago junto con los pasos necesarios para completar la compra.

Ficha OXXO PAY

Inclúyela en tu checkout o envíala por correo para ofrecer una mejor experiencia.

Consulta el repo en Github, o descárgalo aquí.

Paso 5

Recibir notificaciónes

Para poder confirmar los pagos que se realicen con OXXO PAY deberás añadir un Webhook en tu Admin Conekta para recibir las notificaciones POST (HTTP JSON) correctamente.

Utiliza URLs públicos: Si no tienes un IP público o un domino a tu disposición, puedes utilizar servicios como ultrahook o localtunnel. Consultar la referencia sobre webhooks

Paso 6

Notifica a tu cliente

Paso 7

Prueba tu webhook

Dentro de tu Admin Conekta puedes probar la funcionalidad de tu webhook

¿Qué necesitarás? La URL de tu webhook y acceso al Admin Conekta

¡Listo! Recuerda cambiar tus llaves pública y privada después de realizar pruebas.

Existirán casos en los que el método de pago seleccionado no será suficiente, puedes configurar un reintento en caso de que lo veas necesario.

Reintento tarjeta

Reintento otro método

Nosotros recomendamos sugerir otro método de pago cuando los reintentos fallidos de tarjeta fueron más de 3.