Plan de integración sin código

Flujo 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 el formato local antes de la llamada a la API: exactamente 12 caracteres.
• En producción, configure la clave API en el entorno (ISVALID_API_KEY).
• Si es válido, extraiga fisin, cfi_code, moneda, lei y figi.
• Si es 429, aplique respaldo y reintento exponencial.

Flujo 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})?$/

• El formato no válido devuelve un error inmediato.
• Formato válido de consultas API y confirma institución, país y ciudad.
• Estado final: BIC CONFIRMADO o BIC NO ENCONTRADO.

Flujo SBLC/DLC

• No existe una API pública gratuita confiable para la validación directa.
• Realizar validación indirecta: BIC emisor más lista de bancos corresponsales de confianza.
• Abra la tarea manual para confirmarla a través del canal oficial SWIFT (MT799/MT760/MT767).

Almacén de datos 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}
}

Reintento, seguridad y cumplimiento

• Reintento: 3 intentos con retroceso exponencial (1s, 2s, 4s) para 500/502/503/429.
• Utilice HTTPS, desinfecte las entradas y aplique un límite de velocidad por usuario/IP.
• No registre documentos confidenciales en texto sin formato.
• LGPD/GDPR: consentimiento, período de retención, flujo de trabajo de exportación y eliminación.