IBAN Doğrulama

POST /api/v1/validation/iban

curl -X POST https://transfer.payven.com.tr/api/v1/validation/iban \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "X-Tenant-Id: $TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "iban": "TR330006100519786457841326"
  }'

{
  "is_valid":         true,
  "iban":             "TR330006100519786457841326",
  "iban_formatted":   "TR33 0006 1005 1978 6457 8413 26",
  "iban_masked":      "TR33 **** **** **** **** 1326",

  "country_code":     "TR",
  "bank_id":          "bank-garanti-uuid",
  "bank_code":        "GARANTI",
  "bank_name":        "Garanti BBVA",
  "bank_swift":       "TGBATRIS",

  "branch_code":      "00006",
  "account_number":   "1978645784",

  "supported_transfer_types": ["fast", "eft", "remittance"]
}

{
  "is_valid":      false,
  "iban":          "TR330006100519786457841327",
  "error_code":    "checksum_failed",
  "error_message": "IBAN checksum'ı geçmiyor — son hane(ler) hatalı olabilir."
}

let debounceTimer;
ibanInput.addEventListener("input", (e) => {
  clearTimeout(debounceTimer);
  const iban = e.target.value.replace(/\s+/g, "");
  if (iban.length < 26) {
    setBankBadge(null);
    return;
  }
  debounceTimer = setTimeout(async () => {
    const res = await fetch("/api/payven/validate-iban", {
      method: "POST",
      body: JSON.stringify({ iban }),
    });
    const result = await res.json();
    if (result.is_valid) {
      setBankBadge(result.bank_name, result.bank_logo_url);
    } else {
      setError(result.error_message);
    }
  }, 500);
});