Banka Hareketleri
Banka hesabınızın hareketleri, tek uçtan sizin sisteminizde. ödemehub eklediğiniz hesabın hareketlerini bankadan okur ve saklar; siz onları retrieve-bank-transactions ile işaretli tutar, karşı taraf IBAN'ı ve gönderenin açıklamasıyla alırsınız. Bankanın API'siyle siz konuşmazsınız: kimlik bilgilerini bir kez gönderirsiniz, okuma ve token yenileme ödemehub'dadır.
- Bankayı seçme —
retrieve-bankseklenebilen bankaları ve her bankanın istediği kimlik bilgisi alanlarını (fields) döner. - Hesabı ekleme —
create-bank-accountile banka (provider), hesap adı, IBAN ve kimlik bilgilerini (settings) gönderirsiniz. ödemehub bilgileri önce bankada o IBAN için dener. Banka reddederse yanıt yine200'dür:result.successfulfalse,result.messagebankanın mesajı,bank_accountnull; hesap eklenmez. - Token'ı saklama — Yanıttaki
bank_account.token'ı saklayın. Hesap API'de yalnızca bu token'la anılır. - Hareketleri okuma —
retrieve-bank-transactionsile hesap token'larını (bank_account_tokens) ve en fazla 7 günlük aralığı gönderirsiniz; hareketler sayfa sayfa gelir.
Ön koşullar
- Çalışma alanınızda Banka Hareketleri modülü açık olmalıdır; değilse bütün banka uçları
403döner:Çalışma alanınızda bu modül kapalı; açtırmak için bizimle iletişime geçin.Banka uçları Api modülünü istemez. - Bir IBAN çalışma alanına bir kez eklenir. IBAN
TRile başlayan 26 karakter olmalıdır; boşluklar silinir, harfler büyütülür. - Banka hesaplarında test ve canlı ayrımı yoktur: hesap, çalışma alanının modundan bağımsız olarak bankadaki gerçek hesaptan okunur.
Eklenen hesaplar panelde Ödeme Ayarları → Banka Hesapları, hareketleri Banka Hareketleri sayfasında da görünür.
Enpara'dan kimlik bilgileri
Enpara Şirketim internet bankacılığından API hizmetlerine başvurursunuz; client_id, client_secret, access token ve refresh token size e-postayla gelir. Dördü de settings nesnesinde, retrieve-banks yanıtındaki anahtarlarla gönderilir:
settings anahtarı | Enpara'dan gelen |
|---|---|
client_id | Client ID |
client_secret | Client Secret |
access_token | Access Token |
refresh_token | Refresh Token |
- ödemehub token'ları kendisi yeniler. Refresh token 90 gün kullanılmazsa Enpara'dan yeniden alınması gerekir; yenilerini
update-bank-accountile gönderirsiniz. - Aynı
client_idile eklediğiniz hesaplar kimlik bilgilerini paylaşır: bir hesapta gönderdiğiniz yeni bilgiler, oclient_id'yi kullanan diğer hesaplarınızda da geçerli olur. - Kimlik bilgileri hiçbir yanıtta dönmez.
Hesabı ekleme
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.
- PHP
- Node.js
- Python
- Java
use Gurmehub\Odemehub\Request\CreateBankAccount;
$created = $client->createBankAccount(new CreateBankAccount(
provider: 'enpara',
name: 'Tahsilat Hesabı',
iban: 'TR33 0006 1005 1978 6457 8413 26',
settings: [
'client_id' => getenv('ENPARA_CLIENT_ID'),
'client_secret' => getenv('ENPARA_CLIENT_SECRET'),
'access_token' => getenv('ENPARA_ACCESS_TOKEN'),
'refresh_token' => getenv('ENPARA_REFRESH_TOKEN'),
],
));
$bankAccountToken = $created->bankAccount?->token; // banka reddettiyse null; mesajı $created->result->message
const created = await client.createBankAccount({
provider: 'enpara',
name: 'Tahsilat Hesabı',
iban: 'TR33 0006 1005 1978 6457 8413 26',
settings: {
client_id: process.env.ENPARA_CLIENT_ID!,
client_secret: process.env.ENPARA_CLIENT_SECRET!,
access_token: process.env.ENPARA_ACCESS_TOKEN!,
refresh_token: process.env.ENPARA_REFRESH_TOKEN!,
},
});
const bankAccountToken = created.bankAccount?.token; // banka reddettiyse undefined; mesajı created.result.message
import os
from odemehub.request import CreateBankAccount
created = client.create_bank_account(CreateBankAccount(
provider="enpara",
name="Tahsilat Hesabı",
iban="TR33 0006 1005 1978 6457 8413 26",
settings={
"client_id": os.environ["ENPARA_CLIENT_ID"],
"client_secret": os.environ["ENPARA_CLIENT_SECRET"],
"access_token": os.environ["ENPARA_ACCESS_TOKEN"],
"refresh_token": os.environ["ENPARA_REFRESH_TOKEN"],
},
))
created.bank_account # banka reddettiyse None; mesajı created.result.message
import com.odemehub.request.CreateBankAccount;
import java.util.Map;
var created = client.createBankAccount(CreateBankAccount.builder()
.provider("enpara")
.name("Tahsilat Hesabı")
.iban("TR33 0006 1005 1978 6457 8413 26")
.settings(Map.of(
"client_id", System.getenv("ENPARA_CLIENT_ID"),
"client_secret", System.getenv("ENPARA_CLIENT_SECRET"),
"access_token", System.getenv("ENPARA_ACCESS_TOKEN"),
"refresh_token", System.getenv("ENPARA_REFRESH_TOKEN")))
.build());
created.getBankAccount(); // banka reddettiyse null; mesajı created.getResult().getMessage()
Hareketleri okuma
Hareketler bankadan değil, ödemehub'ın sakladığı kayıtlardan döner:
- ödemehub her hesabı saatte bir bankadan okur; yanıttaki hareketler bankanın en fazla yaklaşık bir saat gerisindedir.
- Hesap eklendiğinde son 7 günün hareketleri okunur. Daha eski hareketler gelmez.
- Aynı hareket her sorguda aynı
token'la döner. Hareketleri kendi sisteminizdetoken'la eşleştirin. amountişaretlidir: hesaba giren para artı, çıkan para eksi ("-40.00").created_fromvecreated_to, bankanın hareketi kaydettiği gündür (booked_at), çalışma alanınızın saat diliminde; ödemehub'ın okuduğu an değil.
Hesabın son okuması retrieve-bank-accounts yanıtında görünür: synced_at null ise hesap henüz okunmadı; last_error doluysa son okuma başarısız oldu ve alan bankanın mesajını taşır. Okuma başarısız olmaya başladığında çalışma alanının Yönetici ve Yetkili üyelerine e-posta gider. Çoğu zaman kimlik bilgilerinin süresi dolmuştur; yenilerini update-bank-account ile gönderin.
Yanıt her zaman sayfalıdır; page ve per_page gönderilmezse ilk 250 hareket döner. Yanıttaki pagination.page, pagination.last_page'e ulaşana kadar page'i artırarak sorarsınız:
- PHP
- Node.js
- Python
- Java
use Gurmehub\Odemehub\Request\RetrieveBankTransactions;
$page = 1;
do {
$list = $client->retrieveBankTransactions(new RetrieveBankTransactions(
bankAccountTokens: [$bankAccountToken],
createdFrom: '2026-10-20',
createdTo: '2026-10-26',
page: $page++,
));
foreach ($list->bankTransactions as $bankTransaction) {
$bankTransaction->token;
$bankTransaction->amount; // "22164.96" giren, "-40.00" çıkan
}
} while ($list->pagination->hasMorePages());
let page = 1;
let list;
do {
list = await client.retrieveBankTransactions({
bankAccountTokens: [bankAccountToken],
createdFrom: '2026-10-20',
createdTo: '2026-10-26',
page: page++,
});
for (const bankTransaction of list.bankTransactions) {
bankTransaction.token;
bankTransaction.amount; // "22164.96" giren, "-40.00" çıkan
}
} while (list.pagination.hasMorePages());
from odemehub.request import RetrieveBankTransactions
page = 1
while True:
listing = client.retrieve_bank_transactions(RetrieveBankTransactions(
bank_account_tokens=[bank_account_token],
created_from="2026-10-20",
created_to="2026-10-26",
page=page,
))
for bank_transaction in listing.bank_transactions:
bank_transaction.token
bank_transaction.amount # "22164.96" giren, "-40.00" çıkan
if not listing.pagination.has_more():
break
page += 1
import com.odemehub.request.RetrieveBankTransactions;
int page = 1;
while (true) {
var list = client.retrieveBankTransactions(RetrieveBankTransactions.builder(bankAccountToken)
.between("2026-10-20", "2026-10-26")
.page(page)
.build());
for (var bankTransaction : list.getBankTransactions()) {
bankTransaction.getToken();
bankTransaction.getAmount(); // "22164.96" giren, "-40.00" çıkan
}
if (!list.getPagination().hasMorePages()) {
break;
}
page++;
}
Birden çok hesabın token'ını birlikte gönderebilirsiniz (en fazla 50); hareketler bankanın kayıt anına göre iç içe, eskiden yeniye sıralanır ve her hareket bank_account_token taşır.
Hesabı değiştirme ve silme
update-bank-accounthesabın adını ya da kimlik bilgilerini değiştirir. Yeni kimlik bilgileri önce bankada denenir; banka reddederseresult.successfulfalsedöner ve hiçbir şey değişmez. Banka ve IBAN değişmez; başka bir IBAN başka bir hesaptır.delete-bank-accounthesabı ve ondan okunan bütün hareketleri siler.
Banka hareketleri için webhook gönderilmez; yeni hareketleri retrieve-bank-transactions ile sorarsınız.
Uçlar
| Uç | İşlem |
|---|---|
retrieve-banks | Eklenebilen bankaları ve istedikleri kimlik bilgisi alanlarını listeler. |
create-bank-account | Bağlantıyı bankada dener, başarılıysa hesabı ekler. |
retrieve-bank-accounts | Hesapları token'larıyla ya da hepsini listeler. |
update-bank-account | Hesabın adını ya da kimlik bilgilerini değiştirir. |
delete-bank-account | Hesabı ve hareketlerini siler. |
retrieve-bank-transactions | Hareketleri hesap token'larıyla, en fazla 7 günlük aralıkta, sayfa sayfa listeler. |
Banka hesabı ve hareket nesnelerinin alanları: Banka hesabı nesnesi, Hareket nesnesi.