API Banking Comafi

Integra nuestras soluciones API en tu sistema de gestión para modernizar y simplificar la administración de tu empresa. Además, recibí información de tus movimientos en cuenta, acelera tu proceso de recaudación y realiza transacciones en tiempo real.

Homologación

1 - Kick-off – Primer contacto y alineación

Iniciamos el proceso con una reunión de kick-off, donde el equipo presenta el sistema, las APIs disponibles y las mejores prácticas de integración. Este es el momento ideal para resolver dudas y definir el alcance de la implementación.

2 - Credenciales Sandbox – Entorno de pruebas para empezar a desarrollar

Una vez comprendido el flujo de trabajo, recibirás las credenciales de Sandbox. Con este acceso, puedes comenzar a desarrollar tu integración sin afectar entornos reales.

3 - Desarrollo – Construcción y pruebas en ambiente seguro

Puedes avanzar con la integración, consumiendo las APIs en el entorno de prueba. Durante esta fase, nuestro equipo de soporte está disponible para asistir con dudas y ayudar en la validación de los primeros flujos.

4 - Homologación – Pruebas oficiales y validación técnica

Cuando el desarrollo está listo, puedes iniciar la homologación. Se le asignaran credenciales y un conjunto de pruebas obligatorias que deben completar en un período de dos semanas.

5 - Evaluación – Revisión y feedback del equipo

Una vez que envíen la evidencia de los casos de prueba ejecutados. Nuestro equipo revisa los resultados y proporciona una devolución técnica con observaciones o correcciones necesarias.

6 - Credenciales de Producción – Acceso al entorno real

Si la homologación es exitosa y cumple con los requisitos, se otorgan las credenciales productivas, permitiendo el acceso seguro al entorno real de nuestras APIs.

7 - Operación – Empieza a operar con soporte inicial

Ya puedes operar en producción. Durante este período inicial, realizamos un seguimiento cercano para asegurarnos de que todo funcione correctamente. Luego, el canal de soporte queda disponible para futuras consultas o mejoras.

¿Qué es el ambiente Sandbox?

El ambiente Sandbox es un entorno de pruebas seguro y aislado donde los desarrolladores pueden interactuar con la API sin afectar datos reales o sistemas en producción. Se utiliza para validar integraciones, probar funcionalidades y desarrollar nuevas características antes de llevarlas al ambiente productivo.

¿Qué está mockeado en el Sandbox?

Dado que es un ambiente de prueba, ciertos aspectos de la API están simulados (mockeados) para garantizar estabilidad y evitar interacciones con sistemas financieros reales. Esto incluye:

1. Transacciones

• No se ejecutan transacciones reales, solo se simulan respuestas exitosas o con errores controlados.

1. Autenticación y Seguridad

• Los tokens de autenticación en el Sandbox pueden ser estáticos o tener una validación más laxa en comparación con producción.

1. Datos de Usuarios y Cuentas

• Se proporcionan cuentas, clientes y datos ficticios, pero con estructuras similares a las reales.

1. Procesamiento de Operaciones

• En producción, algunas operaciones dependen de entidades externas (bancos, sistemas de clearing). En Sandbox, estas respuestas están predefinidas o generadas con lógica simulada.

1. Notificaciones y Webhooks

• Los eventos asincrónicos como notificaciones de transacciones pueden estar programados para responder con ejemplos predefinidos en lugar de reflejar eventos en tiempo real.

¿Por qué usar Sandbox?

Permite desarrollar e integrar sin riesgo de afectar datos reales. Facilita la automatización de pruebas. Asegura una experiencia realista antes de desplegar a producción. En resumen, el Sandbox es un entorno esencial para garantizar que la integración con la API sea fluida, predecible y libre de riesgos antes de ponerla en producción.

Como reportar una incidencia

Con el fin de garantizar una respuesta más rápida y efectiva al momento de reportar inconvenientes en nuestras APIs y poder tener un mejor entendimiento del inconveniente, necesitaremos que nos informes los siguientes datos:

1. Ambiente: Indica en qué ambiente se encuentra el problema:
   • Homologación
   • Producción
2. Detalle del Endpoint: Especifica claramente el endpoint sobre el cual tienes problemas o consultas.
3. Ejemplo de la Petición: Si es posible, envía un ejemplo del curl de la petición que estás realizando.
4. Captura de Pantalla: Adjunta una captura de pantalla de la respuesta obtenida para facilitar el análisis.
5. Protección de Credenciales: Nunca compartas credenciales productivas sin ofuscar, incluyendo el accessToken si estás enviando una petición de producción.
6. Información de Cuentas: Proporciona los detalles completos de las cuentas afectadas (como CUIT, CBU, o Nro de cuenta).
7. Mantener un Solo Hilo de Correo: Mantén todas las consultas sobre un mismo tema en un solo hilo de correo para evitar confusiones o duplicaciones.
8. No Mezclar Temas: Si tienes una nueva consulta diferente, abre un nuevo hilo de correo. No mezcles temas en el mismo hilo.
9. Detalles Completo de la Petición: Siempre incluye:
   • El body de la petición.
   • La fecha y hora de la ejecución.
   • El body de la respuesta y el status code obtenido.
10. Casos relacionados con las APIs de transferencias: Es imprescindible que nos proporcionen el ID utilizado en el POST para cada transferencia junto con los datos mencionados anteriormente.
11. Movimientos o Cash-In: Si la consulta está relacionada con un cash-in o un movimiento de cuenta, añade el ID Coelsa y/o el ID de Conciliación.

IMPORTANTE: No Compartir Credenciales de Producción. NUNCA compartas credenciales productivas sin ofuscar. Esto incluye el accessToken si envías un curl de producción. Asegúrate de eliminar o enmascarar cualquier información sensible.

1. Comunicación mediante mails: Cualquier comunicación relacionada con la APP de Apibanking (ya sea para reportar errores o realizar consultas), debe incluir siempre en copia la dirección de correo [email protected]. Esto asegura que nuestro equipo de desarrollo y atención al cliente acceda rápidamente a su solicitud. Si lo desean, pueden agregar en copia a otras personas relevantes, pero la casilla mencionada debe estar incluida para evitar demoras o posibles omisiones.

Alerta

NUNCA compartas credenciales productivas sin ofuscar. Esto incluye el accessToken si envías un curl de producción. Asegúrate de eliminar o enmascarar cualquier información sensible.

Nadie te pedirá NUNCA que compartas el client_secret completo.

Asegúrate siempre de usar los canales oficiales para realizar las consultas.

IMPORTANTE

Tanto en los ambientes de QA como de Producción, es fundamental que su integración permita extraer fácilmente los campos relacionados con los errores. Esto nos ayudará a analizar los problemas de forma más ágil al contar con el mensaje de error que nuestras APIs les hayan enviado.