Saltar al contenido principal

Crear una API key

Para comenzar, primero necesitas generar una API key en el portal de pey.

1. Crea un perfil​

Entra a portal.mipey.mx y crea un perfil. Si ya tienes un perfil, omite este paso.

2. Agrega una cuenta de pago​

Ve a la sección "Finanzas" del sitio y crea una cuenta de pago. Hay dos tipos de cuentas de pago:

Descripción
stripeAgrega tu información bancaria a través de nuestra integración con Stripe para recibir tarjetas, Apple Pay y Google Pay.
codiSolo funciona con cuentas bancarias mexicanas, agregas directamente tu información bancaria existente para recibir pagos CoDi®.
aviso

Registrar una cuenta bancaria tarda 5 días hábiles en completarse el registro con Banxico.

Comienza a probar de inmediato

Mientras se activa tu cuenta bancaria, puedes registrar la siguiente cuenta. Se activa de inmediato, así que puedes empezar a probar en producción el mismo día:

  • CLABE: 012180015826225713
  • Nombre: Ramón Orraca Lascurain

Los pagos enviados a esta cuenta no serán devueltos, así que solo prueba con montos pequeños como $0.01 MXN

Registra cuentas bancarias a través de la API

También puedes registrar cuentas bancarias CoDi de forma programática con Register Bank Account y consultar su estado con Get Bank Account. Envía el id de la cuenta como bankAccountId al crear un QR o una notificación push CoDi para recibir ese pago en ella.

Elegir una opción de finanzas para aceptar pagos

3. Crea una API key​

Después de completar la configuración de tu cuenta de pago, ve a la sección Desarrollador del sitio. Se encuentra en la barra lateral.

Haz clic en el botón "Crear API Key" y asígnale un nombre. Se te pedirá vincular una de las cuentas de pago creadas previamente a tu API key.

info

Cada API key puede estar asociada a una cuenta de pago codi y a una stripe al mismo tiempo. Se requiere al menos una de las dos para crear la API key.

Prueba en producción​

Te recomendamos probar tu integración directamente en producción. Así pruebas con bancos reales, recibes notificaciones CoDi® y webhooks reales, y ves exactamente el mismo flujo que vivirán tus clientes.

  • Usa montos pequeños. Crea pagos por montos como $0.01 MXN para que probar no te cueste casi nada.
  • No esperes a tu cuenta bancaria. Si tu propia cuenta aún se está activando, registra la cuenta bancaria de pruebas de arriba, que se activa de inmediato.
nota

Pronto tendremos un entorno de pruebas dedicado. Aun así, probar en producción seguirá siendo la forma más confiable de validar tu integración de principio a fin.