Cetak Biru Integrasi Tanpa Kode

Aliran 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

• Validasi format lokal sebelum panggilan API: tepat 12 karakter.
• Dalam produksi, konfigurasikan kunci API di lingkungan (ISVALID_API_KEY).
• Jika valid, ekstrak fisin, cfi_code, mata uang, lei dan figi.
• Jika 429, terapkan fallback dan percobaan ulang eksponensial.

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

• Format yang tidak valid langsung menghasilkan kesalahan.
• API kueri format yang valid dan mengonfirmasi institusi, negara, dan kota.
• Status akhir: BIC DIKONFIRMASI atau BIC TIDAK DITEMUKAN.

Aliran SBLC / DLC

• Tidak ada API publik gratis yang tepercaya untuk validasi langsung.
• Lakukan validasi tidak langsung: penerbit BIC ditambah daftar bank koresponden terpercaya.
• Buka tugas manual untuk konfirmasi melalui saluran SWIFT resmi (MT799/MT760/MT767).

Penyimpanan Data yang Disarankan

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

Coba Lagi, Keamanan dan Kepatuhan

• Coba lagi: 3 kali percobaan dengan backoff eksponensial (1 detik, 2 detik, 4 detik) untuk 500/502/503/429.
• Gunakan HTTPS, bersihkan input, dan terapkan batas kecepatan berdasarkan pengguna/IP.
• Jangan mencatat dokumen sensitif dalam teks biasa.
• LGPD/GDPR: persetujuan, periode retensi, alur kerja ekspor dan penghapusan.