Ana içeriğe geç

retrieve-payment-providers

POST /api/{team}/gateway/retrieve-payment-providers

Ödeme hesaplarını döndürür; hiçbir şeyi değiştirmez. Token'larını gönderdiğiniz hesaplar ya da, göndermezseniz, çalışma alanının bütün hesapları eskiden yeniye gelir. Liste sayfalı değildir. Hesapların ayarları dönmez.

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​

{ "tokens": ["9b2f4c1e-7a3d-4e8b-b5f6-2c9d0e1a7f43"] }
AlanTipZorunluAçıklama
tokensarrayhayırHesapların token'ları (UUID), en fazla 50. Gönderilmezse ya da boşsa bütün hesaplar döner.

SDK örnekleri​

not

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

use Gurmehub\Odemehub\Request\RetrievePaymentProviders;

$all = $client->retrievePaymentProviders()->paymentProviders;
$some = $client->retrievePaymentProviders(new RetrievePaymentProviders(tokens: [$paymentProviderToken]))->paymentProviders;

foreach ($all as $paymentProvider) {
$paymentProvider->token; // name, provider, isDefault, createdAt
}

Yanıt​

{
"result": { "successful": true, "message": null },
"payment_providers": [
{
"token": "9b2f4c1e-7a3d-4e8b-b5f6-2c9d0e1a7f43",
"name": "EsnekPos",
"provider": "esnekpos",
"is_default": true,
"created_at": "2026-11-05T09:35:00.000000Z"
}
]
}

payment_providers: Ödeme hesabı nesneleri. Eşleşen yoksa boş liste.

HTTP durum kodları​

KodDurum
200Liste döndü.
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.
422Doğrulama hatası.
429İstek sınırı aşıldı.