Banka verinizi kendi sistemlerinize bağlayın
BankaPro API, Banka.pro'ya bağlı bütün banka hesaplarınızın bakiye ve hareketlerini muhasebe, ERP veya kendi yazılımınıza aktaran bir REST API'dir. Bankaları tek tek bağlamakla uğraşmazsınız; tek anahtar, tek sözleşme.
https://api.banka.pro/v1
$ curl https://api.banka.pro/v1/bank-transactions \
-u "$KEY_ID:$SECRET"{
"success": true,
"data": [{
"direction": "incoming",
"amount": "12500.00",
"currency": "TRY",
"status": 0
}],
"meta": { "page": 1, "total": 1340 }
}Kapsam
Hesaplar, hareketler ve banka sorgusu tek API'de
API, Banka.pro'daki verinizi okur ve hareketleri işaretlemenizi sağlar; bankaya ödeme ya da transfer talimatı göndermez.
Banka hesapları ve bakiyeler
Hesapları, para birimi bazında bakiye özetini ve günlük bakiye geçmişini alın.
- GET /v1/bank-accounts
- GET /v1/bank-accounts/summary
- GET /v1/bank-accounts/{id}/balance-history
Banka hareketleri
Hareketleri tarih, yön, para birimi, hesap ve duruma göre süzün; gelen, giden ve net özeti para birimi bazında alın.
- GET /v1/bank-transactions
- GET /v1/bank-transactions/summary
- GET /v1/bank-transactions/{id}
Durum ve not
Hareketleri işlendi veya yok sayıldı olarak işaretleyin, not ekleyin. Değişiklik BankaPro uygulamasında da görünür.
- PATCH /v1/bank-transactions/{id}/status
- POST /v1/bank-transactions/bulk-actions
- PUT /v1/bank-transactions/{id}/note
Manuel banka sorgusu
Düzenli sorguyu beklemeden bir hesabı ya da bütün hesapları bankadan hemen sorgulatın.
- POST /v1/bank-queries
Entegrasyon
Üç adımda başlayın
- 1
Anahtar oluşturun
Firma yöneticisi Banka.pro web panelindeki API anahtarları sayfasından anahtar oluşturur; yetkileri, IP kısıtını ve erişim bitiş tarihini seçer.
Hızlı başlangıç - 2
Hareketleri aktarın
İlk aktarımdan sonra updatedSince ile yalnız yeni ve güncellenen hareketleri çekin; durum ve not değişiklikleri de gelir.
Artımlı eşitleme - 3
Gerekirse bankayı sorgulatın
Güncel veri hemen gerekiyorsa manuel sorgu başlatın, ardından değişen hareketleri alın.
Manuel banka sorgusu
Güvenlik ve yetkiler
Her anahtar yalnız ihtiyacı kadarını görür
HTTP Basic, yalnız HTTPS
Anahtar kimliği ve secret key ile kimlik doğrulanır. Secret key yalnız oluşturulduğunda bir kez gösterilir.
Firmaya bağlı anahtar
Her anahtar tek bir firmanın verisine erişir; firma istekten değil anahtarın kendisinden belirlenir.
Ayrıntılı yetkiler
Hesaplar, Hareketler, İşlemler, Banka sorgusu ve Kişisel veriler yetkileri anahtar başına ayrı ayrı verilir.
IP kısıtı ve erişim süresi
Anahtarı en çok 20 IP adresine sınırlayın; erişim bitiş tarihinden sonra anahtar kendiliğinden kapanır.
Kişisel veriler maskeli
Kişisel veriler yetkisi yoksa karşı tarafın IBAN'ı ve TCKN/VKN'si, açıklama ve not içindekiler dahil maskelenir.
Yalnız sunucudan sunucuya
Tarayıcıdan gelen istekler reddedilir; anahtarınız istemci uygulamalarında açığa çıkmaz.
Öngörülebilir bir sözleşme
API referansı OpenAPI 3 sözleşmesinden üretilir; her uç için parametreler, yanıt şemaları ve hazır kod örnekleri dokümantasyondadır.
Veri kuralları- Tutarlar iki ondalıklı metin; farklı para birimleri tek toplamda birleştirilmez
- Bilinmeyen bakiye null, bankanın bildirdiği gerçek sıfır 0.00
- Zamanlar UTC; tarih filtreleri İstanbul gün sınırıyla
- Her yanıtta izleme için x-request-id
- Sabit hata kodları ve tek tip hata zarfı
- Sayfalama, filtre ve metin araması
SSS
BankaPro API hakkında sorular
Henüz Banka.pro kullanmıyor musunuz?
API, Profesyonel ve Kurumsal paketlerde açıktır. Bankalarınızı bağlamak için demo talep edin; 14 gün ücretsiz deneyin, kredi kartı gerekmez.
