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:

┌─────────────┐    ┌─────────────┐    ┌──────────────┐    ┌─────────────┐
│   Sender     │    │  Compliance  │    │    Quote     │    │  Recipient   │
│  Onboarding  │───▶│ Verification │───▶│   (FX Rate)  │───▶│    Setup     │
│   (KYC)      │    │              │    │              │    │              │
└─────────────┘    └─────────────┘    └──────────────┘    └─────────────┘
                                                                 │
┌─────────────┐    ┌─────────────┐    ┌──────────────┐          │
│   Receipt    │    │  Transaction │    │   Funding    │◀─────────┘
│  (Regulated) │◀───│  Execution   │◀───│   Source     │
│              │    │              │    │  (Card/ACH)  │
└─────────────┘    └─────────────┘    └──────────────┘

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.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Frontend   │────▶│  Your Server │────▶│   Inyo API   │
│ (React, etc) │     │  (BFF Layer) │     │  (Sandbox /  │
│              │◀────│              │◀────│  Production) │
└──────────────┘     └──────────────┘     └──────────────┘
                      Holds API keys       KYC, FX, Payout
                      Orchestrates calls   Compliance engine

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
Especificación OpenAPI: Documentación interactiva de la API
Soporte: Póngase en contacto con nuestro equipo de ventas