Homologación (Certification Process)

La homologación es el proceso de validación conjunta entre el equipo de API Broker y el equipo técnico del partner, previo al pase a producción. Su objetivo es verificar que la integración funciona correctamente en todos los flujos críticos, que los webhooks responden como se espera y que el sistema está listo para operar con usuarios reales.

No es un trámite formal: es una sesión de trabajo en conjunto donde se simulan escenarios reales y se detectan y corrigen problemas antes del go live.

¿Cuándo se hace la homologación?

La homologación ocurre una vez que el partner completó el desarrollo sobre el ambiente de Staging y considera que la integración está lista. Es el paso previo a la entrega de credenciales de producción.

Firma de NDA → Credenciales Staging → Desarrollo → Homologación → Credenciales PRD → Beta → Go Live

Requisitos previos

Antes de iniciar la homologación, el partner debe tener integrado y funcionando en Staging:

Onboarding completo: alta de persona, documentación, cuenta comitente y cuenta bancaria
Webhook deposit_create configurado y respondiendo HTTP 200
Webhook investment_account_update configurado y respondiendo HTTP 200
Flujo de Cash In funcionando (al menos un depósito acreditado en Staging)
Los módulos contratados integrados: Remuneración de Saldo, FCI, Dólar MEP y/o Trading
Webhook withdraw_request_update configurado si el partner habilita retiros
Manejo de estados implementado en la UI del partner

Si alguno de estos puntos no está listo, coordinar con el oficial de cuenta antes de agendar la sesión. Una homologación incompleta genera retrabajo y demora el go live.

Escenarios que se validan

Onboarding

Escenario	Qué se verifica
Alta de persona física	Campos obligatorios, PEP, FATCA, OCDE
Alta de persona jurídica	Datos societarios, beneficiario final, documentación
Carga de documentación	Identidad (DNI + selfie) y contratos societarios
Alta de cuenta comitente	Perfil de inversión, `investment_account_id` generado
Webhook `investment_account_update`	Recepción correcta y procesamiento del evento
Alta de cuenta bancaria	Validación same-name, `bank_account_id` generado
Casos de error	Respuesta ante CUIT duplicado, documentación faltante, CBU inválido

Cash In

Escenario	Qué se verifica
Depósito en ARS	Acreditación en cuenta comitente correcta
Depósito en USD	Acreditación en cuenta comitente correcta
Webhook `deposit_create`	Recepción, parseo correcto y HTTP 200 de respuesta
Idempotencia del webhook	Comportamiento ante reenvío del mismo evento
Depósito de CUIT no registrado	Manejo del caso donde el depositante no tiene cuenta

Módulos operativos (según los contratados)

Escenario	Qué se verifica
Activación de Remuneración de Saldo	TyC aceptados, flag activo, parámetros `minimum_left` y `currency_id`
Suscripción a FCI	Endpoint, método ACDI/SIMPLE, body correcto
Rescate de FCI	Rescate total y parcial, `by_share_quantity`
Compra de Dólar MEP	Consulta de cotización, instrucción de orden, liquidación T+0
Venta de Dólar MEP	Flujo inverso, acreditación en ARS
Orden de compra (Trading)	Envío de orden, manejo de estados
Orden de venta (Trading)	Envío de orden, manejo de estados
Manejo de estados de órdenes	`SENDING_PENDING`, `OFFERED`, `COMPLETED`, `REJECTED`, `EXPIRED`

Cash Out

Escenario	Qué se verifica
Retiro en ARS	Solicitud, estado `IN_PROGRESS` y `COMPLETED`
Retiro en USD	Solicitud, estado `IN_PROGRESS` y `COMPLETED`
Webhook `withdraw_request_update`	Recepción y procesamiento correcto
Retiro rechazado	Manejo del estado `REJECTED` y `status_message`
Retiro a cuenta no same-name	Comportamiento ante validación fallida
`external_id` duplicado	Comportamiento idempotente ante reintento

Pruebas de carga y robustez

Escenario	Qué se verifica
Duplicación de requests	El sistema no genera operaciones duplicadas
Timeout y reintentos	El partner maneja correctamente reintentos sin duplicar
Webhooks en ráfaga	La URL del partner responde correctamente ante múltiples eventos simultáneos
Conciliación de saldos	Los saldos del Back Office coinciden con los de la API

Proceso de la sesión

La homologación se realiza de forma conjunta entre el equipo técnico del partner y el equipo de API Broker. La dinámica habitual es:

Kickoff: el equipo de API Broker repasa los escenarios a validar y confirma el ambiente.
Ejecución de escenarios: se recorren los casos uno por uno. El partner ejecuta las operaciones desde su integración y API Broker verifica el resultado del lado de la plataforma.
Registro de observaciones: los puntos que no pasan se documentan con detalle para que el partner los corrija.
Re-validación: una vez corregidos los puntos pendientes, se re-ejecutan los escenarios afectados.
Aprobación: cuando todos los escenarios críticos están validados, API Broker aprueba la homologación y procede con la entrega de credenciales de producción.

La homologación puede realizarse en una o varias sesiones según la complejidad de la integración y los módulos contratados.

Criterios de aprobación

Para que una homologación sea aprobada deben cumplirse los siguientes criterios:

✅ Onboarding completo funciona sin errores para PF y PJ
✅ Los tres webhooks obligatorios responden HTTP 200 y procesan el payload correctamente
✅ Al menos un depósito fue acreditado y reflejado correctamente en la UI del partner
✅ Los módulos contratados ejecutan operaciones de punta a punta sin errores
✅ Los estados de órdenes y retiros se reflejan correctamente en la UI del partner
✅ El sistema maneja correctamente los estados finales negativos (REJECTED, NOT_SENT, EXPIRED)
✅ No se detectan problemas de duplicación ni idempotencia

Los escenarios marcados como observaciones menores pueden quedar pendientes para corrección post go live, a criterio del equipo de API Broker.

Entregables de la homologación

Al finalizar el proceso, API Broker entrega:

Confirmación formal de aprobación
Lista de observaciones resueltas y pendientes (si aplica)
Credenciales de Producción: API keys, URLs y configuración del ambiente PRD
Configuración de webhooks en producción
Asignación de oficial de cuenta para el acompañamiento en Beta y Go Live

Preguntas frecuentes

¿Cuánto dura una homologación?

Depende de la cantidad de módulos integrados y el estado de la integración. Una integración con todos los módulos bien desarrollada puede homologarse en una sesión de 2 a 3 horas. Si hay observaciones, puede requerir sesiones adicionales.

¿Qué pasa si no paso la homologación?

API Broker entrega un listado detallado de los puntos pendientes. El partner los corrige en Staging y se agenda una nueva sesión para revalidar únicamente los puntos observados.

¿Puedo hacer la homologación de un módulo y el resto después?

Sí. Es posible homologar módulos de forma incremental. Por ejemplo, homologar onboarding + remuneración de saldo primero y sumar FCI o Trading en una segunda etapa.

¿Necesito preparar algo especial para la sesión?

Tener el ambiente de Staging operativo, con al menos un usuario dado de alta y con saldo disponible. El equipo de API Broker coordina los detalles antes de la sesión.

Contacto

Para agendar la sesión de homologación o consultar sobre el estado de tu integración:

📩 [email protected]