SOLUCIONES DE PAGOS Y RECAUDOS S.A.S. – “FINITY”
Versión: 1.0 · Vigente desde el 5 de noviembre de 2026
Conecta tu empresa a Finity
Este manual te explica cómo conectarte a Finity y qué necesitas tener listo antes de operar en producción. Aquí encontrarás el proceso general; el detalle técnico de cada servicio está en nuestra documentación oficial, que forma parte de este manual en su versión vigente:
1. Formas de conexión
Puedes operar con Finity de tres maneras, según lo que necesite tu empresa:
- Portal empresarial. Para gestionar de forma manual cuentas, conversiones, pagos, retiros, movimientos y links de pago.
- API REST. Para automatizar desde tus propios sistemas la consulta de saldos, el registro de cuentas externas, las tasas y conversiones, los retiros, los links de pago y los movimientos.
- Host to Host (H2H). Para el intercambio de información con entidades financieras, cuando así lo prevea el contrato.
2. Ambientes
Contamos con dos ambientes. En sandbox (https://sandbox.dev.finity.com.co) puedes hacer todas las pruebas que necesites sin mover dinero real. En producción (https://api.finity.com.co) se ejecutan las operaciones reales.
La API es REST, responde en formato JSON y usa los métodos y códigos HTTP estándar. La versión vigente se identifica en la ruta de cada servicio (/v0/).
3. Paso a paso
- Vinculación. Completas el proceso de debida diligencia (KYB) y firmas el contrato.
- Credenciales de prueba. Te entregamos por un canal seguro un client_id y un client_secret para el ambiente de sandbox.
- Autenticación. Con esas credenciales obtienes un token mediante el flujo OAuth2 de credenciales de cliente (POST /v0/oauth/token) y lo envías como Bearer en el encabezado Authorization de cada solicitud.
- Pruebas. Pruebas en sandbox los flujos que vas a usar en tu operación.
- Salida a producción. Terminadas las pruebas, te entregamos las credenciales de producción y habilitamos los servicios contratados.
4. Buenas prácticas de seguridad
- No guardes credenciales ni tokens en el código fuente ni en repositorios.
- Usa credenciales distintas para sandbox y producción, y guárdalas por separado.
- Conéctate a la API siempre a través de HTTPS.
- Limita el acceso a las credenciales a las personas que realmente lo necesiten.
- Si sospechas que una credencial se vio comprometida, escríbenos de inmediato a soporte@finity.com.co para revocarla.
5. Nuevas versiones
Podemos publicar nuevas versiones de la API y retirar servicios obsoletos. Cuando un cambio afecte tu integración, te avisaremos con una ventana de transición razonable y con la documentación actualizada. Los cambios urgentes por razones de seguridad podrán aplicarse de inmediato.
6. Soporte
Si necesitas ayuda con la integración, escríbenos a soporte@finity.com.co. Los tiempos de respuesta son los del acuerdo de niveles de servicio de tu contrato, según la severidad del caso.
