API Reference MarketplaceSplit Payment Session

Split Payment Session

POST/v1/payments/sessionsOptional

Create a payment session that splits the captured amount across one or more submerchants. Each split names a submerchant and its share; the platform keeps the remainder. Split recipients must be active (KYC-approved).

Authentication

Signature Pattern

HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/payments/sessions\n{sha256(body)}")

Header	Value	Description
`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)

Request Parameters

Name	Type	Required	Description
`transactionId`	string	Required	Unique merchant transaction id
`amount`	integer	Required	Total amount in kuruş
`currency`	string	Required	Always "TRY"
`returnUrl`	string	Required	Redirect URL after checkout
`splits`	array	Required	[{submerchantId, amountMinor}] — the platform keeps the remainder

Request Example

JSONRequest Body

{
  "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
    }
  ]
}

Response Parameters

Field	Type	Example
`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"

Response Example

JSONResponse

{
  "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"
}

Status Codes

200Success

201Created

400Bad Request

401Unauthorized

404Not Found

429Rate Limited

Try itMock

POSThttps://api.pay.sandbox.kvell.group

Submerchant Payout→