Ana içeriğe geç

update-bank-account

POST /api/{team}/gateway/update-bank-account/{token}

Hesabın adını ya da kimlik bilgilerini değiştirir; yalnızca gönderilen alanlar değişir. settings gönderilirse yeni bilgiler önce bankada, hesabın IBAN'ıyla denenir. Banka reddederse yanıt 200'dür, result.successful false olur ve hiçbir şey değişmez; ad da. Banka ve IBAN değiştirilemez; başka bir IBAN için create-bank-account ile yeni hesap eklenir.

Aynı client_id ile eklenmiş hesaplar kimlik bilgilerini paylaşır: bir hesapta değiştirilen bilgiler, o client_id'yi kullanan diğer hesaplarda da geçerli olur. Bkz. Enpara'dan kimlik bilgileri.

Kimlik doğrulama​

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

İstek​

{
"token": "5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54",
"bank_account": {
"name": "Ana Hesap",
"settings": {
"access_token": "...",
"refresh_token": "..."
}
}
}
AlanTipZorunluAçıklama
tokenstringevetHesabın token'ı. Adresteki token'la aynı olmalıdır.
bank_accountobjectevetYalnızca name ve settings taşır; başka anahtar gönderilirse 422.
bank_account.namestringhayırYeni ad. Gönderilirse boş olamaz; en çok 255 karakter.
bank_account.settingsobjecthayırYalnızca değişecek kimlik bilgileri; gönderilmeyenler korunur. Anahtarlar retrieve-banks yanıtındaki fields[].key; gönderilen her biri boş olmayan string, en çok 4000 karakter.

SDK örnekleri​

not

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

use Gurmehub\Odemehub\Request\UpdateBankAccount;

$updated = $client->updateBankAccount(new UpdateBankAccount(
token: $bankAccountToken,
settings: [
'access_token' => $newAccessToken,
'refresh_token' => $newRefreshToken,
],
));

$updated->bankAccount?->lastError; // banka reddettiyse bankAccount null; mesajı $updated->result->message

Yanıt​

create-bank-account ile aynıdır: result ve hesabın güncel hâli (bank_account). Banka yeni kimlik bilgilerini reddederse result.successful false, result.message bankanın mesajı, bank_account null'dır.

Alanlar: Banka hesabı nesnesi.

HTTP durum kodları​

KodDurum
200İstek işlendi; sonuç result.successful içinde.
401API anahtarı ya da imza geçersiz.
403Çalışma alanı işlem yapamıyor ya da Banka Hareketleri modülü kapalı.
404Bu banka hesabı bulunamadı.
422Doğrulama hatası.
429İstek sınırı aşıldı.

Hatalar​

AlanMesaj
tokenGövdedeki token adresteki token ile aynı olmalı.