Modelo de integração sem código

Fluxo ISIN

Method: GET
URL: https://api.isvalid.dev/v0/isin?value={{isin_input}}
Headers:
  Accept: application/json
  User-Agent: [your-app]/1.0
  Authorization: Bearer {{ISVALID_API_KEY}}
Rate Limit: according to your API plan

• Valide o formato local antes da chamada da API: exatamente 12 caracteres.
• Na produção, configure a chave API no ambiente (ISVALID_API_KEY).
• Se válido, extraia fisin, cfi_code, moeda, lei e figi.
• Se for 429, aplique fallback e nova tentativa exponencial.

Fluxo SWIFT/BIC

Method: GET
URL: https://api.isvalid.dev/v0/bic?value={{bic_input}}
Headers:
  Accept: application/json
  Authorization: Bearer {{ISVALID_API_KEY}}
Regex BIC: /^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/

• Formato inválido retorna erro imediato.
• Formato válido consulta API e confirma instituição, país e cidade.
• Status final: BIC CONFIRMADO ou BIC NÃO ENCONTRADO.

Fluxo SBLC/DLC

• Não existe uma API pública gratuita e confiável para validação direta.
• Realizar validação indireta: BIC emissor mais lista de bancos correspondentes confiáveis.
• Abra tarefa manual para confirmação via canal SWIFT oficial (MT799/MT760/MT767).

Armazenamento de dados sugerido

{
  "id": "uuid",
  "tipo_documento": "ISIN|SWIFT|SBLC|DLC",
  "valor_documento": "string",
  "status_validacao": "PENDENTE|VALIDO|INVALIDO|ERRO|MANUAL",
  "data_validacao": "timestamp",
  "fonte_validacao": "isvalid|swiftref|manual",
  "dados_resposta": {"json_original": "{}"},
  "flags": {"alerta_fraude": true, "requer_acao_manual": false}
}

Nova tentativa, segurança e conformidade

• Nova tentativa: 3 tentativas com espera exponencial (1s, 2s, 4s) para 500/502/503/429.
• Use HTTPS, limpe entradas e imponha limite de taxa por usuário/IP.
• Não registre documentos confidenciais em texto simples.
• LGPD/GDPR: consentimento, período de retenção, fluxo de trabalho de exportação e exclusão.