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

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 SPEI

Puedes incluirla en tu checkout o envíala por correo para ofrecer una mejor experiencia.

Consulta el repo en GitHub. Descargar repo

Paso 5

Recibir notificación

Para poder confirmar los pagos que se realicen con SPEI 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.