Ana içeriğe geç

update-payment-provider

POST /api/{team}/gateway/update-payment-provider/{token}

Hesabın adını ya da ayarlarını değiştirir, hesabı çalışma alanının varsayılan hesabı yapar; yalnızca gönderilen alanlar değişir. Sağlayıcı değiştirilemez; başka bir sağlayıcı için create-payment-provider ile yeni hesap eklenir. Ayarlar sağlayıcıda denenmez.

Yalnızca iş ortağının açtığı çalışma alanlarında çalışır; diğerleri 403 alır. Bkz. İş Ortakları.

Kimlik doğrulama​

Çalışma alanının anahtarıyla: X-Api-Key, X-Timestamp, X-Signature, Content-Type: application/json. Ayrıntılar: Kimlik Doğrulama ve İmza.

İstek​

{
"token": "9b2f4c1e-7a3d-4e8b-b5f6-2c9d0e1a7f43",
"payment_provider": {
"name": "EsnekPos Ana",
"settings": { "merchant": "MERCHANT", "merchant_key": "KEY" },
"is_default": true
}
}
AlanTipZorunluAçıklama
tokenstringevetHesabın token'ı. Adresteki token'la aynı olmalıdır.
payment_providerobjectevetDeğişecek alanlar.
payment_provider.namestringhayırYeni ad. Gönderilirse boş olamaz; en çok 255 karakter.
payment_provider.settingsobjecthayırYalnızca değişecek ayarlar; anahtarlar create-payment-provider ile aynı. Gönderilmeyenler korunur.
payment_provider.is_defaultbooleanhayırYalnızca true: hesap varsayılan olur, önceki varsayılan hesap varsayılan olmaktan çıkar. Varsayılanlık false göndererek kaldırılmaz; başka bir hesap varsayılan yapılır. Alternatif ödeme yöntemi varsayılan yapılamaz.

SDK örnekleri​

not

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

use Gurmehub\Odemehub\Request\UpdatePaymentProvider;

$paymentProvider = $client->updatePaymentProvider(new UpdatePaymentProvider(
token: $paymentProviderToken,
isDefault: true,
))->paymentProvider;

$paymentProvider->isDefault; // true

Yanıt​

result ve hesabın güncel hâli (payment_provider): Ödeme hesabı nesnesi.

HTTP durum kodları​

KodDurum
200Hesap güncellendi.
401API anahtarı ya da imza geçersiz.
403Çalışma alanı işlem yapamıyor ya da bir iş ortağının açtığı çalışma alanı değil: Bu uç yalnızca iş ortağı çalışma alanlarına açıktır.
404Bu ödeme hesabı bulunamadı.
422Doğrulama hatası.
429İstek sınırı aşıldı.

Hatalar​

AlanMesaj
tokenGövdedeki token adresteki token ile aynı olmalı.
payment_provider.is_defaultAlternatif ödeme yöntemi varsayılan ödeme hesabı yapılamaz.