Población de Datos

Antes de construir los flujos de transacciones, necesita poblar su aplicación con datos de referencia de la API de Inyo. Estos datos incluyen los países de payout disponibles, los esquemas requeridos para destinatarios y cuentas, y las listas de bancos.

Resumen

Endpoint	Propósito	Duración de la Caché
Países de Payout	Países de destino disponibles para un corredor de origen	24 horas
Esquema de Destinatario	Campos requeridos para crear un destinatario en un país dado	24 horas
Esquema de Cuenta de Destinatario	Campos requeridos para vincular una cuenta bancaria en un país dado	24 horas
Esquema de Transacción	Campos `additionalData` específicos por país para transacciones	24 horas
Bancos de un País	Lista de bancos disponibles para un país de destino	24 horas

Límites de Tasa

Todos los endpoints de población de datos están sujetos a límites de tasa estrictos. Estos endpoints sirven datos de referencia que cambian con poca frecuencia — se espera que usted almacene las respuestas en caché localmente y las actualice periódicamente (recomendado: cada 24 horas).

No llame a estos endpoints en cada transacción. Las llamadas excesivas resultarán en respuestas 429 Too Many Requests.

Estrategia de Caché Recomendada

// Ejemplo: caché con TTL de 24 horas
const NodeCache = require('node-cache');
const cache = new NodeCache({ stdTTL: 86400 }); // 24 horas

async function getDestinations(sourceCountry) {
  const cacheKey = `destinations:${sourceCountry}`;
  let data = cache.get(cacheKey);
  
  if (!data) {
    data = await inyoApi.get(`/payout/${sourceCountry}/destinations`);
    cache.set(cacheKey, data);
  }
  
  return data;
}

Integración Guiada por Esquemas

Un principio de diseño clave de la API de Inyo es que los requisitos de datos varían según el país. En lugar de codificar de forma fija los requisitos de campos, su integración debería:

Obtener el esquema del país de destino
Renderizar formularios dinámicamente según los campos requeridos/opcionales
Validar la entrada del usuario contra el esquema antes de enviarla

Este enfoque asegura que su aplicación se adapte automáticamente cuando Inyo añada nuevos países o cambie los requisitos — sin cambios de código de su parte.

User selects destination country
        │
        ▼
Fetch recipient schema ──────────▶ Build person form
Fetch account schema ────────────▶ Build bank account form
Fetch bank list (if needed) ─────▶ Populate bank dropdown
Fetch transaction schema ────────▶ Collect additionalData fields