Remesas
La API de Remesas ofrece una solución completa de extremo a extremo para construir aplicaciones de pagos transfronterizos. Combina los Servicios Core de Inyo (infraestructura regulatoria y licencias de transmisión de dinero), la Plataforma de Cumplimiento (KYC, KYB, AML y antifraude) y el Payment Gateway (recaudación y desembolso de fondos) en una única integración unificada.
Cómo Funciona
Una transacción de remesa sigue un ciclo de vida bien definido que garantiza el cumplimiento regulatorio en cada paso:
flowchart TD
subgraph s1["1 - Remitente"]
A["Registro"] --> B["Cumplimiento"]
end
subgraph s2["2 - Preparación"]
C["Cotización"] --> D["Beneficiario"] --> E["Fondos"]
end
subgraph s3["3 - Liquidación"]
F["Ejecución"] --> G["Comprobante"]
end
s1 --> s2
s2 --> s3
Pasos de Integración
| Paso | Acción | Endpoint | Descripción |
|---|---|---|---|
| 1 | Onboarding del Remitente | POST /people | Cree el remitente y active el screening de KYC/AML |
| 2 | Verificación de Cumplimiento | GET /participants/{id}/complianceLevels | Verifique que el remitente haya alcanzado al menos el Level 1 |
| 3 | Destinos | GET /payout/{country}/destinations | Obtenga los corredores de payout disponibles |
| 4 | Obtener una Cotización | POST /payout/quotes | Fije la tasa de FX y las comisiones |
| 5 | Configuración del Destinatario | POST /people | Cree el beneficiario usando los esquemas específicos de cada país |
| 6 | Cuenta del Destinatario | POST /payout/participants/{id}/recipientAccounts/gateway | Vincule la cuenta bancaria del destinatario |
| 7 | Fuente de Fondeo | POST /payout/participants/{id}/fundingAccounts | Registre la tarjeta o cuenta ACH del remitente |
| 8 | Verificación de Límites | GET /fx/participants/{id}/limits | Verifique que el remitente no haya excedido los límites de transacción |
| 9 | Ejecutar la Transacción | POST /fx/transactions | Envíe la transacción con todos los ID vinculados |
| 10 | Webhooks | POST /webhooks | Regístrese para recibir notificaciones de estado en tiempo real |
Patrón de Arquitectura
Inyo requiere una arquitectura Backend-for-Frontend (BFF). Sus credenciales de API (x-api-key, x-agent-id, x-agent-api-key) nunca deben exponerse a clientes frontend o móviles.
flowchart TB
subgraph client["Client"]
F["Frontend<br/>(React, móvil)"]
end
subgraph yours["Su infraestructura"]
S["Su servidor (BFF)<br/>guarda x-api-key, x-agent-id,<br/>x-agent-api-key"]
end
subgraph inyo["Inyo"]
A["API de remesas<br/>KYC, cambio, payout, cumplimiento"]
end
F -->|"acciones del usuario"| S
S -->|"llamadas autenticadas"| A
A -->|"resultados"| S
S -->|"nunca las credenciales"| F
Pautas de Caché
La API de Inyo aplica límites de tasa en los endpoints de data population. Implemente el almacenamiento en caché de la siguiente manera:
| Datos | Duración del Caché | Razón |
|---|---|---|
| Destinos y bancos | 24 horas | Rara vez cambian |
| Límites de cumplimiento | 24 horas (o hasta que ocurra una transacción) | Semiestáticos |
| Esquemas de destinatario/cuenta | 24 horas | Rara vez cambian |
| Cotizaciones | Nunca almacenar en caché | Sensibles al tiempo — válidas 30 minutos por defecto; verifique siempre expireAt |
Requisitos de Red
La API de Remesas está protegida en el borde de la red: cada solicitud debe presentar un certificado de cliente TLS mutuo, y su IP de egreso debe estar en la lista de permitidos. Ambos se aprovisionan durante el onboarding — vea Conectividad.
¿Necesita Ayuda?
- Implementación de referencia: Proyecto de Ejemplo de Remesas — una aplicación funcional en Node.js + React que demuestra la integración completa
- Soporte: Póngase en contacto con nuestro equipo de ventas