Alt Üye İşyerine Ödeme
POST
/v1/payoutsOptionalBir alt üye işyerine ödeme gönderir. Üst üye işyeri submerchantId değerini iletir; hedef IBAN/hesap sahibi bilgisi sunucu tarafında alt üye işyeri kaydından alınır (bir alt üye işyerinin kendi anahtarı yalnızca kendisine ödeme yapabilir). Alt üye işyerinin defter hesaplarına ve daha düşük limitlere yönlendirilir.
Kimlik Doğrulama
İmza Deseni
HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/payouts\n{sha256(body)}")| Başlık | Değer | Açıklama |
|---|---|---|
X-Api-Key | pk_live_a1b2c3d4e5f6g7h8 | Merchant public API key |
X-Signature | {hmac_sha256_hex} | Hex HMAC-SHA256 request signature |
X-Timestamp | 2026-04-13T10:00:00Z | ISO 8601 UTC request time (±5 min) |
İstek Parametreleri
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
submerchantId | string | Zorunlu | Submerchant to pay (IBAN/holder sourced server-side) |
rail | string | Zorunlu | "fast" | "eft" | "card" |
amountMinor | integer | Zorunlu | Amount in kuruş |
currency | string | Zorunlu | Always "TRY" |
clientReference | string | İsteğe Bağlı | Merchant pass-through reference |
İstek Örneği
JSONİstek Gövdesi
{
"submerchantId": "sub_1a2b3c4d",
"rail": "fast",
"amountMinor": 20000,
"currency": "TRY"
}Yanıt Parametreleri
| Alan | Tür | Örnek |
|---|---|---|
payoutId | string | "1a2b3c4d-5e6f-7081-92a3-b4c5d6e7f809" |
status | string | "pending" |
submerchantId | string | "sub_1a2b3c4d" |
Yanıt Örneği
JSONYanıt
{
"payoutId": "1a2b3c4d-5e6f-7081-92a3-b4c5d6e7f809",
"status": "pending",
"submerchantId": "sub_1a2b3c4d"
}Durum Kodları
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
POSThttps://api.pay.sandbox.kvell.group