Hata kodları

Kodlanmış domain ve güvenlik hataları status: false, kararlı bir code, açıklayıcı message ve gerektiğinde meta içerir. Alan doğrulama hatalarının eski wire formatında result[] bulunabilir; 404 gibi bazı genel cevaplarda yalnız status: false dönebilir. Entegrasyon mantığını önce HTTP status, bulunduğunda code üzerine kurun.

{
  "status": false,
  "code": "TRANSACTION_CURSOR_PAGE_SIZE_INVALID",
  "message": "Cursor sayfalamasında pageSize en fazla 100 olabilir.",
  "meta": {
    "maxPageSize": 100
  }
}

HTTP	Anlam
`400`	Eksik tenant header veya geçersiz istek
`401`	API credential eksik, geçersiz, süresi dolmuş veya revoke edilmiş
`402`	Paket ya da kullanım limiti reddi
`403`	API kapsamı veya firma sınırı reddi
`404`	Firma kapsamında kayıt bulunamadı
`405`	Provider kaynaklı banka hareketine yazma denendi
`409`	Duplicate bağlantı veya optimistic version çakışması
`413`	CSV satır sınırı aşıldı
`422`	Doğrulanan DSL veya domain kuralı reddedildi
`429`	Global ya da firma rate limit’i
`502/503`	Dış bağlantı veya bağımlılık geçici olarak hazır değil

Hareket sorgularında TRANSACTION_AMOUNT_RANGE_INVALID, TRANSACTION_DATE_RANGE_INVALID ve TRANSACTION_CURSOR_PAGE_SIZE_INVALID; hareket yazma denemesinde TRANSACTION_WRITE_NOT_ALLOWED dönebilir. Erişim politikalarında ACCESS_IP_DENIED ve ACCESS_TIME_DENIED kodları kullanılabilir.

API credential hataları

HTTP	Kod	Anlam
`401`	`API_KEY_REQUIRED`	`x-api-key` ve `x-api-secret` çifti eksik
`401`	`INVALID_API_CREDENTIAL`	Credential geçersiz, süresi dolmuş veya revoke edilmiş
`403`	`API_SCOPE_REQUIRED`	Endpoint için gerekli `bank:*` kapsamı yok

Kimlik doğrulama hatalarında anahtar veya secret değerini loglamayın.

Çoklu IBAN hataları

HTTP	Kod	Anlam
`422`	`BANK_ACCOUNT_TARGET_REQUIRED`	Banka bağlantısı için en az bir hedef IBAN gerekir
`422`	`BANK_ACCOUNT_TARGET_INVALID`	Bir hedef IBAN biçim veya checksum doğrulamasından geçmedi
`422`	`BANK_ACCOUNT_TARGET_DUPLICATE`	Normalize edilmiş hedef listesinde tekrar var
`422`	`BANK_ACCOUNT_TARGET_LIMIT_EXCEEDED`	Bir bağlantıdaki hedef sayısı 10 sınırını aştı
`502`	`BANK_ACCOUNT_TARGET_QUERY_FAILED`	Hedeflerden biri için banka sorgusu tamamlanamadı
`502`	`PROVIDER_STAMP_COLLISION`	Farklı hesap hareketleri aynı provider stamp ile döndü

BANK_ACCOUNT_TARGET_QUERY_FAILED cevabındaki güvenli meta.targetIndex alanını ve connector logundaki correlation kimliğini kullanarak hatalı hedef sırasını bulun. PROVIDER_STAMP_COLLISION durumunda hareketleri birleştirmeyin veya istemci tarafında üretmeyin; correlation kimliğiyle destek kaydı oluşturun. Geçici 502/503 hatalarında exponential backoff ve jitter uygulayın. Senkronizasyon tekrarlarında idempotency davranışını koruyun.

Hoş geldiniz

Başlangıç

Firma ve erişim

Banka bağlantıları

Banka hareketleri

Otomasyon

Operasyon

Kaynaklar

API credential hataları

Çoklu IBAN hataları

​API credential hataları

​Çoklu IBAN hataları

API credential hataları

Çoklu IBAN hataları