Plan d'intégration sans code

Flux 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

• Validez le format local avant l'appel de l'API : exactement 12 caractères.
• En production, configurez la clé API dans l'environnement (ISVALID_API_KEY).
• S'il est valide, extrayez le fisin, le cfi_code, la devise, le lei et le figi.
• Si 429, appliquez une solution de secours et une nouvelle tentative exponentielle.

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

• Un format invalide renvoie une erreur immédiate.
• Un format valide interroge l’API et confirme l’institution, le pays et la ville.
• Statut final : BIC CONFIRMÉ ou BIC NON TROUVÉ.

Flux SBLC/DLC

• Il n’existe pas d’API publique gratuite et fiable pour la validation directe.
• Effectuer une validation indirecte : BIC de l'émetteur et liste des banques correspondantes de confiance.
• Ouvrez la tâche manuelle pour confirmation via le canal SWIFT officiel (MT799/MT760/MT767).

Magasin de données suggéré

{
  "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}
}

Nouvelle tentative, sécurité et conformité

• Réessayez : 3 tentatives avec une interruption exponentielle (1 s, 2 s, 4 s) pour 500/502/503/429.
• Utilisez HTTPS, nettoyez les entrées et appliquez une limite de débit par utilisateur/IP.
• Ne consignez pas les documents sensibles en texte brut.
• LGPD/RGPD : consentement, durée de conservation, workflow d'exportation et de suppression.