Para Transferi Oluştur
POST
/v1/payoutsOptionalBir TR IBAN'ına (rail "fast" veya "eft") ya da token yönlendirmesiyle bir karta (rail "card") transfer gönderir. payable_now kontrolünü çalıştırır, defteri kilitler ve sağlayıcıya iletir. status "pending" olarak döner; nihai durum payout.* webhook'u üzerinden gelir. İsteğe bağlı bir Idempotency-Key başlığını destekler.
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 |
|---|---|---|---|
storeId | string | Zorunlu | Store the payout draws from |
rail | string | Zorunlu | "fast" | "eft" | "card" |
iban | string | Zorunlu | Destination TR IBAN (validated mod-97; empty for card rail) |
holderName | string | Zorunlu | Account holder name |
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
{
"storeId": "sto_5a6b7c8d",
"rail": "fast",
"iban": "TR330006100519786457841326",
"holderName": "Acme Ltd",
"amountMinor": 100000,
"currency": "TRY"
}Yanıt Parametreleri
| Alan | Tür | Örnek |
|---|---|---|
payoutId | string | "7c8d9e0f-1a2b-3c4d-5e6f-708192a3b4c5" |
status | string | "pending" |
Yanıt Örneği
JSONYanıt
{
"payoutId": "7c8d9e0f-1a2b-3c4d-5e6f-708192a3b4c5",
"status": "pending"
}Durum Kodları
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
POSThttps://api.pay.sandbox.kvell.group