Data Population

Antes de construir os fluxos de transação, você precisa popular sua aplicação com dados de referência da API da Inyo. Esses dados incluem os países de payout disponíveis, os schemas exigidos para destinatários e contas, e as listas de bancos.

Visão Geral

Endpoint	Finalidade	Duração do Cache
Países de Payout	Países de destino disponíveis para um corredor de origem	24 horas
Schema de Destinatário	Campos obrigatórios para criar um destinatário em um determinado país	24 horas
Schema de Conta do Destinatário	Campos obrigatórios para vincular uma conta bancária em um determinado país	24 horas
Schema de Transação	Campos `additionalData` específicos por país para transações	24 horas
Bancos em um País	Lista de bancos disponíveis para um país de destino	24 horas

Limites de Taxa

Todos os endpoints de data population estão sujeitos a limites de taxa rigorosos. Esses endpoints servem dados de referência que mudam com pouca frequência — espera-se que você armazene as respostas em cache localmente e as atualize periodicamente (recomendado: a cada 24 horas).

Não chame esses endpoints a cada transação. Chamadas excessivas resultarão em respostas 429 Too Many Requests.

Estratégia de Cache Recomendada

// Exemplo: cache com 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;
}

Integração Orientada por Schema

Um princípio de design fundamental da API da Inyo é que os requisitos de dados variam por país. Em vez de codificar fixamente os requisitos de campos, sua integração deve:

Buscar o schema do país de destino
Renderizar formulários dinamicamente com base nos campos obrigatórios/opcionais
Validar a entrada do usuário contra o schema antes de enviar

Essa abordagem garante que sua aplicação se adapte automaticamente quando a Inyo adicionar novos países ou alterar requisitos — sem mudanças de código do seu lado.

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