Toplu Para Transferi Taslağı Oluştur
POST
/v1/payout-draftsOptionalİncelenmek üzere bir grup planlanan para transferi yükler. Her satır yapısal olarak doğrulanır. Taslağı onaylamak, geçerli her satırı gerçek bir para transferine dönüştürür. En fazla 1000 satır; taslak başına bir mağaza. dest = IBAN (fast/eft) veya kart token'ı (card); bu değer hiçbir zaman yanıtta geri döndürülmez.
Kimlik Doğrulama
İmza Deseni
HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/payout-drafts\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 all rows draw from |
rows | array | Zorunlu | [{rail, dest, holderName, amountMinor, currency}] |
İstek Örneği
JSONİstek Gövdesi
{
"storeId": "sto_5a6b7c8d",
"rows": [
{
"rail": "fast",
"dest": "TR330006100519786457841326",
"holderName": "Acme Ltd",
"amountMinor": 100000,
"currency": "TRY"
},
{
"rail": "eft",
"dest": "TR120006200119000006672315",
"holderName": "Beta AŞ",
"amountMinor": 50000,
"currency": "TRY"
}
]
}Yanıt Parametreleri
| Alan | Tür | Örnek |
|---|---|---|
draftId | string | "drf_8192a3b4c5d6" |
status | string | "draft" |
rowCount | integer | 2 |
validCount | integer | 2 |
invalidCount | integer | 0 |
createdAt | string | "2026-04-13T10:00:00Z" |
Yanıt Örneği
JSONYanıt
{
"draftId": "drf_8192a3b4c5d6",
"status": "draft",
"rowCount": 2,
"validCount": 2,
"invalidCount": 0,
"createdAt": "2026-04-13T10:00:00Z"
}Durum Kodları
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
POSThttps://api.pay.sandbox.kvell.group