Saltar al contenido principal

Preguntas Frecuentes

General​

¿Qué es la API de YAPU?​

La API de YAPU es una capa de integración basada en REST que permite a las instituciones financieras clientes y sus sistemas intercambiar datos con la plataforma YAPU. Admite casos de uso como el envío de datos de cuestionarios, la obtención de reportes, la verificación de elegibilidad de clientes, entre otros.

¿Necesito un contrato para iniciar una integración API?​

Sí. Todas las integraciones con la API de YAPU requieren un contrato activo. El proceso de entrega comienza después de la firma del contrato. Comuníquese con su representante YAPU para iniciar la conversación.

¿YAPU SNAP es lo mismo que los bundles estándar de API?​

No. YAPU SNAP es una API independiente (standalone) — opera de forma autónoma y no requiere ninguna otra API ni contexto de la plataforma YAPU. Los bundles estándar de API son no independientes y dependen del ecosistema de la plataforma YAPU. Consulte YAPU SNAP y API Bundles para más detalles.

¿Puedo usar más de un bundle de API?​

Sí. Algunos escenarios de integración implican el uso combinado de múltiples bundles. Su contacto en YAPU le ayudará a identificar la combinación adecuada durante la fase de especificación.

Requisitos técnicos​

¿Qué lenguaje de programación o plataforma requiere YAPU?​

Ninguno en particular. Las APIs de YAPU son APIs REST estándar sobre HTTPS con JSON. Cualquier plataforma o lenguaje que pueda realizar solicitudes HTTPS y procesar JSON puede integrarse con YAPU.

¿YAPU admite comunicación con IP estática?​

No. YAPU admite únicamente comunicación con IP dinámica. No se admite la inclusión de IPs estáticas en listas blancas. Si su infraestructura tiene requisitos específicos al respecto, consúltelo con su contacto en YAPU antes de la fase de especificación.

¿YAPU admite HTTP (sin cifrado)?​

No. Toda la comunicación debe realizarse sobre HTTPS. No se aceptan solicitudes HTTP.

¿Qué formato utilizan las solicitudes a la API de YAPU?​

Todas las solicitudes a la API de YAPU son solicitudes JSON individuales sobre HTTPS. Los bundles estándar no admiten formatos de solicitud multiparte ni por lotes.

YAPU devuelve los datos como strings — ¿qué significa eso?​

Los datos salientes de YAPU (de YAPU hacia su sistema) se entregan como valores de tipo string. Su equipo de desarrollo es responsable de parsear y convertir estos strings a los tipos de datos adecuados para su aplicación (por ejemplo, números, fechas, booleanos).

Autenticación​

¿Cómo obtengo las credenciales de API?​

Las credenciales son proporcionadas por su contacto en YAPU durante la fase de incorporación y especificación. Nunca se publican en este portal.

¿Las credenciales de staging y producción son las mismas?​

No. Los entornos de staging y producción tienen credenciales separadas. Nunca utilice credenciales de staging en producción ni viceversa.

¿Qué debo hacer si creo que mis credenciales fueron comprometidas?​

Comuníquese de inmediato con su representante de YAPU. Consulte Soporte y Contacto para los contactos de escalación.

Proceso de integración​

¿Cuánto tiempo toma una integración con la API de YAPU?​

Una integración típica tarda entre 4 y 13 semanas desde la firma del contrato:

  • Especificación: 1–3 semanas
  • Desarrollo: 2–8 semanas
  • Pruebas: 1–2 semanas

La fase de desarrollo varía según la priorización interna de YAPU y la velocidad de desarrollo de su equipo.

¿Quién crea la documentación técnica de la API?​

YAPU elabora la documentación técnica de la API durante la fase de especificación. Ambas partes deben acordarla antes de que comience el desarrollo.

¿Debo preparar algo antes de la llamada de especificación?​

Resulta útil tener claridad sobre:

  • Qué proceso de negocio debe soportar la integración
  • Qué datos tiene actualmente su sistema y en qué formato se encuentran
  • Qué información necesita recibir su sistema desde YAPU

Revise previamente el resumen de API Bundles para identificar qué caso de uso se ajusta a sus necesidades.

¿Puedo empezar el desarrollo antes de que se acuerde la especificación?​

Se recomienda firmemente no iniciar el desarrollo antes de que la documentación técnica haya sido acordada mutuamente. Comenzar sin una especificación acordada es una causa frecuente de trabajo adicional y retrasos.

Datos y formatos​

¿Qué formato de datos requiere YAPU para los datos entrantes?​

YAPU requiere que los datos entrantes sigan formatos específicos de YAPU definidos para cada bundle de API. Estos formatos están documentados en la documentación técnica de la API proporcionada durante la fase de especificación.

¿Puede YAPU adaptarse a nuestro formato de datos?​

La fase de especificación incluye un proceso de alineación de datos en el que YAPU guía al cliente para definir los campos y formatos requeridos. El objetivo es alcanzar un formato acordado antes de que comience el desarrollo.

Soporte​

¿A quién contacto si tengo una pregunta técnica durante la integración?​

Su representante asignado del equipo de Customer Success o Digitalización de YAPU es su principal punto de contacto. Consulte Soporte y Contacto para conocer las opciones de contacto.

¿Existe un proceso de soporte después del go-live?​

Sí. Tras el go-live, se inicia un período de estabilización durante el cual YAPU monitorea la integración y permanece disponible para atender escalaciones. Consulte Pruebas y Go-Live para más detalles.