Skip to main content
Tahsil Banka API; bir firmanın banka bağlantılarını kurar, hesap hareketlerini tek biçimde toplar ve hareketleri harici kayıtlarla eşleştirmenizi sağlar. İstemciler yalnız https://api.tahsil.dev adresindeki müşteri API’sini çağırır.

Banka bağlantısını kurun

Bağlantıyı oluşturun, credential’ı güvenle kaydedin, setup ve ilk senkronizasyonu tamamlayın.

Hareketleri okuyun

Değiştirilemez banka hareketlerini filtreleyin, sayfalayın ve detayını inceleyin.

Mutabakatı otomatikleştirin

Önizleme, backfill ve manuel atamalarla hareketleri kendi kayıtlarınıza bağlayın.

Operasyonu izleyin

Dashboard, kullanım, bağlantı sağlığı ve güvenli connector loglarıyla akışın durumunu takip edin.

​
Önerilen entegrasyon sırası

  1. Mavi Rota Teknoloji A.Ş. için gerekli kapsamları taşıyan bir API credential oluşturun.
  2. Her istekte x-api-key ve x-api-secret header’larını birlikte gönderin.
  3. x-company-id: 66b0f09a8f10000000000001 ile Aktifbank bağlantısını oluşturup iki IBAN’ı kaydedin.
  4. Setup ve sync adımlarını tamamlayın.
  5. GET /banks/transactions ile txn-aktifbank-202607150001 hareketini okuyun.
  6. Hareketi manuel atama veya önizlenmiş bir kuralla invoice/INV-2026-1042 kaydına bağlayın.
  7. Schedule, dashboard, usage ve connector loglarını izleyin.
Banka hareketleri banka senkronizasyonuyla oluşur ve finansal kayıt olarak değiştirilemez. Public API’de hareket oluşturma, güncelleme veya silme yoktur.

​
Cevap sözleşmesi

Başarılı JSON cevapları status: true ve result alanlarını taşır. Offset listelerinde paginate, cursor listelerinde pageInfo bulunur.
Kodlanmış domain ve güvenlik hataları status: false, kararlı code, kullanıcıya gösterilebilir message ve gerekirse meta döndürür. Entegrasyon kararlarını mesaj metnine değil HTTP status ile, bulunduğunda code değerine bağlayın.

​
API referansını güvenle kullanın

Salt okunur operasyonları API referansındaki Test Request alanından doğrudan production API’ye gönderebilirsiniz. Mintlify proxy’si kullanılmaz. Yalnız bu amaç için oluşturulmuş, gerektiğinde revoke edebileceğiniz bir test API credential kullanın. x-api-key ve x-api-secret değerlerini birlikte girin; banka credential’ı paylaşmayın. Yazma operasyonları portalda kopyalanabilir örnek olarak kalır.