Bölüştürmeli Ödeme Oturumu
POST
/v1/payments/sessionsOptionalÇekilen tutarı bir veya daha fazla alt üye işyeri arasında bölüştüren bir ödeme oturumu oluşturur. Her bölüştürme, bir alt üye işyerini ve payını belirtir; platform kalan tutarı alır. Bölüştürmeden pay alan taraflar aktif (KYC onaylı) olmalıdır.
Kimlik Doğrulama
İmza Deseni
HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/payments/sessions\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 |
|---|---|---|---|
transactionId | string | Zorunlu | Unique merchant transaction id |
amount | integer | Zorunlu | Total amount in kuruş |
currency | string | Zorunlu | Always "TRY" |
returnUrl | string | Zorunlu | Redirect URL after checkout |
splits | array | Zorunlu | [{submerchantId, amountMinor}] — the platform keeps the remainder |
İstek Örneği
JSONİstek Gövdesi
{
"transactionId": "ORDER-2026-777",
"amount": 30000,
"currency": "TRY",
"returnUrl": "https://marketplace.example.com/return",
"splits": [
{
"submerchantId": "sub_1a2b3c4d",
"amountMinor": 20000
},
{
"submerchantId": "sub_5e6f7081",
"amountMinor": 8000
}
]
}Yanıt Parametreleri
| Alan | Tür | Örnek |
|---|---|---|
sessionId | string | "4d4e8a9c-1f2a-7b8c-9d0e-1f3f1c9a2e6b" |
checkoutUrl | string | "https://pay.kvell.group/s/4d4e8a9c-1f2a-… |
expiresAt | string | "2026-04-13T10:30:00Z" |
amount | integer | 30000 |
currency | string | "TRY" |
status | string | "active" |
Yanıt Örneği
JSONYanıt
{
"sessionId": "4d4e8a9c-1f2a-7b8c-9d0e-1f3f1c9a2e6b",
"checkoutUrl": "https://pay.kvell.group/s/4d4e8a9c-1f2a-7b8c-9d0e-1f3f1c9a2e6b",
"expiresAt": "2026-04-13T10:30:00Z",
"amount": 30000,
"currency": "TRY",
"status": "active"
}Durum Kodları
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
POSThttps://api.pay.sandbox.kvell.group