Pazaryeri

Ödemeleri alt üye işyerleri arasında bölüştürün ve alt üye işyerlerine ödeme yapın. Kayıt ve KYC panelde yürütülür.

2 endpoints

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.

İ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

JSONİstek Örneği

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

JSONYanıt Örneği

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

POST/v1/payoutsOptional

Bir 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.

İ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

JSONİstek Örneği

{
  "submerchantId": "sub_1a2b3c4d",
  "rail": "fast",
  "amountMinor": 20000,
  "currency": "TRY"
}

JSONYanıt Örneği

{
  "payoutId": "1a2b3c4d-5e6f-7081-92a3-b4c5d6e7f809",
  "status": "pending",
  "submerchantId": "sub_1a2b3c4d"
}

Kategori Özeti

Toplam Endpoint

Ana Domain

api.pay.kvell.group