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": "..."
}
}
}
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
token | string | evet | Hesabın token'ı. Adresteki token'la aynı olmalıdır. |
bank_account | object | evet | Yalnızca name ve settings taşır; başka anahtar gönderilirse 422. |
bank_account.name | string | hayır | Yeni ad. Gönderilirse boş olamaz; en çok 255 karakter. |
bank_account.settings | object | hayır | Yalnı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
Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.
- PHP
- Node.js
- Python
- Java
- cURL
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
const updated = await client.updateBankAccount({
token: bankAccountToken,
settings: { access_token: newAccessToken, refresh_token: newRefreshToken },
});
updated.bankAccount?.lastError; // banka reddettiyse bankAccount null; mesajı updated.result.message
from odemehub.request import UpdateBankAccount
updated = client.update_bank_account(UpdateBankAccount(
token=bank_account_token,
settings={"access_token": new_access_token, "refresh_token": new_refresh_token},
))
updated.bank_account # banka reddettiyse None; mesajı updated.result.message
import com.odemehub.request.UpdateBankAccount;
import java.util.Map;
var updated = client.updateBankAccount(UpdateBankAccount.builder(bankAccountToken)
.settings(Map.of("access_token", newAccessToken, "refresh_token", newRefreshToken))
.build());
updated.getBankAccount(); // banka reddettiyse null; mesajı updated.getResult().getMessage()
URI_PATH="/api/$ODEMEHUB_TEAM/gateway/update-bank-account/5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54"
BODY='{"token":"5c1e9a72-3b4d-4f8e-a6c2-1d7b9e0f3a54","bank_account":{"name":"Ana Hesap"}}'
TIMESTAMP=$(date +%s)
SIGNATURE=$(printf '%s\n%s\n%s\n%s' "$TIMESTAMP" "POST" "$URI_PATH" "$BODY" | openssl dgst -sha256 -hmac "$ODEMEHUB_API_SECRET" | sed 's/^.* //')
curl -X POST "https://sandbox.odemehub.com$URI_PATH" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $ODEMEHUB_API_KEY" \
-H "X-Timestamp: $TIMESTAMP" \
-H "X-Signature: $SIGNATURE" \
--data-raw "$BODY"
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ı
| Kod | Durum |
|---|---|
200 | İstek işlendi; sonuç result.successful içinde. |
401 | API anahtarı ya da imza geçersiz. |
403 | Çalışma alanı işlem yapamıyor ya da Banka Hareketleri modülü kapalı. |
404 | Bu banka hesabı bulunamadı. |
422 | Doğrulama hatası. |
429 | İstek sınırı aşıldı. |
Hatalar
| Alan | Mesaj |
|---|---|
token | Gövdedeki token adresteki token ile aynı olmalı. |