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"] }
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
tokens | array | hayır | Hesapları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.
- PHP
- Node.js
- Python
- Java
- cURL
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
}
const all = (await client.retrievePaymentProviders()).paymentProviders;
const some = (await client.retrievePaymentProviders({ tokens: [paymentProviderToken] })).paymentProviders;
for (const paymentProvider of all) {
paymentProvider.token; // name, provider, isDefault, createdAt
}
from odemehub.request import RetrievePaymentProviders
every = client.retrieve_payment_providers().payment_providers
some = client.retrieve_payment_providers(RetrievePaymentProviders(tokens=[payment_provider_token])).payment_providers
for payment_provider in every:
payment_provider.token # name, provider, is_default, created_at
import com.odemehub.request.RetrievePaymentProviders;
var all = client.retrievePaymentProviders(RetrievePaymentProviders.all()).getPaymentProviders();
var some = client.retrievePaymentProviders(RetrievePaymentProviders.byTokens(paymentProviderToken)).getPaymentProviders();
for (var paymentProvider : all) {
paymentProvider.getToken(); // getName(), getProvider(), isDefault(), getCreatedAt()
}
URI_PATH="/api/$ODEMEHUB_TEAM/gateway/retrieve-payment-providers"
BODY='{}'
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
{
"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ı
| Kod | Durum |
|---|---|
200 | Liste döndü. |
401 | API 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. |
422 | Doğrulama hatası. |
429 | İstek sınırı aşıldı. |