Ana içeriğe geç

retrieve-bank-accounts

POST /api/{team}/gateway/retrieve-bank-accounts

Banka hesaplarını döndürür; hiçbir şeyi değiştirmez. Token'larını gönderdiğiniz hesaplar ya da, token göndermezseniz, çalışma alanının bütün hesapları eskiden yeniye gelir. Hesabın son okumasının ne zaman yapıldığını (synced_at) ve başarısız olduysa nedenini (last_error) buradan izlersiniz. Akış: Banka Hareketleri rehberi.

Kimlik doğrulama​

X-Api-Key, X-Timestamp, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza.

İstek​

{ "tokens": ["5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54"] }
{}
AlanTipZorunluAçıklama
tokensarrayhayırHesapların token'ları (UUID), en fazla 50. Gönderilmezse ya da boşsa çalışma alanının bütün hesapları döner.

Yanıt her zaman bir listedir; eşleşen hesap yoksa liste boştur. Başka bir çalışma alanının hesabı hiçbir zaman dönmez; onun token'ı hiçbir şey bulmaz.

SDK örnekleri​

not

Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.

use Gurmehub\Odemehub\Request\RetrieveBankAccounts;

$accounts = $client->retrieveBankAccounts(new RetrieveBankAccounts([$bankAccountToken]));
// bütün hesaplar: new RetrieveBankAccounts()

$accounts->bankAccounts[0]->lastError; // son okuma başarısızsa bankanın mesajı

Yanıt​

{
"result": { "successful": true, "message": null },
"bank_accounts": [
{
"token": "5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54",
"provider": "enpara",
"name": "Tahsilat Hesabı",
"iban": "TR330006100519786457841326",
"synced_at": "2026-10-26T09:00:12.000000Z",
"last_error": null,
"created_at": "2026-10-26T08:12:00.000000Z"
}
]
}
AlanTipAçıklama
bank_accounts[]arrayBanka hesabı nesneleri, eskiden yeniye.

Banka hesabı nesnesi​

Banka hesabı uçlarının hepsinde aynı nesne döner. Kimlik bilgileri (settings) hiçbir yanıtta yer almaz.

AlanTipAçıklama
tokenstringHesabın token'ı. Hareketler retrieve-bank-transactions isteğinde bank_account_tokens ile bu token'la sorulur.
providerstringBankanın kimliği: enpara.
namestringHesabın adı.
ibanstringBoşluksuz, büyük harfli IBAN.
synced_atstring | nullHareketlerin bankadan son başarılı okunduğu an, ISO 8601 UTC. null: hesap henüz okunmadı.
last_errorstring | nullSon okuma başarısız olduysa bankanın mesajı; başarılı bir okumadan sonra null olur.
created_atstringHesabın eklendiği an, ISO 8601 UTC.

last_error doluyken yeni hareketler gelmez. Çoğu zaman kimlik bilgilerinin süresi dolmuştur; yenilerini update-bank-account ile gönderin.

HTTP durum kodları​

KodDurum
200Liste döndü; eşleşen hesap yoksa boş.
401API anahtarı ya da imza geçersiz.
403Çalışma alanı işlem yapamıyor ya da Banka Hareketleri modülü kapalı.
422Doğrulama hatası: tokens liste değil, 50'den fazla ya da bir token UUID değil.
429İstek sınırı aşıldı.