Komisyon Önizleme

POST/partner/1.0/pos/commission/quote

Gerekli scope: payment:inquiry

Ödemeden önce müşterinin ödeyeceği nihai tutarı ve komisyon kırılımını döner. Para hareketi yoktur, kayıt oluşturmaz.

Hesaplama, ödemeyi çeken uçla aynı komisyon kaynağını kullanır; burada dönen customerPays ile Kart Ödemesi sonucunda çekilen tutar aynıdır (aradan geçen sürede komisyon yapılandırmanız değişmediyse).

Taksit

Taksit yalnızca method: "POS" için anlamlıdır ve komisyon oranını değiştirir. Kart ödemesini kaç taksitle çekecekseniz önizlemeyi de aynı installment ile isteyin.

subType göndermeyin

Kart POS'unun geçerli tek alt tipi DEFAULT'tur; subType alanını boş bırakın, sunucu ödeme yöntemine göre çözer. Var olmayan bir (tip, alt tip) çifti verirseniz eşleşen POS bulunamaz.

Örnek

curl -X POST https://<host>/partner/1.0/pos/commission/quote \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "method": "POS",
  "amount": 100,
  "installment": 3,
  "currency": "TRY"
}'

İstek Body

Alan	Tip	Açıklama
`method`	enum	Ödeme yöntemi. Boş bırakılırsa POS (kart) kabul edilir — Partner API bir kart tahsilat yüzeyidir. Varsayılan: `POS` `POSWALLETLOYALTYCASHFREE`
`amount`zorunlu	decimal	Sipariş (net) tutarı. 0'dan büyük olmalıdır.
`installment`	integer	Taksit sayısı. Yalnız POS için geçerli; boş veya 0 ise tek çekim.
`currency`	enum	Para birimi. Boş bırakılırsa TRY. Varsayılan: `TRY`
`subType`	enum	Dikey POS alt-tipi. Boş bırakın — kart için DEFAULT, cüzdan/puan rayları için BASIC olarak çözülür. Varsayılan: `DEFAULT` `DEFAULTBASICSTREAMINGCHARITYFOODFUEL`

Yanıt

Alan	Anlamı
`baseAmount`	Gönderdiğiniz net sipariş tutarı.
`commissionRate`	Uygulanan komisyon oranı (yüzde).
`commissionAmount`	Hesaplanan komisyon tutarı.
`customerPays`	Müşterinin ödeyeceği nihai tutar.
`merchantNet`	İşletmenizin eline geçen net tutar.
`applyType`	Komisyonun kime yansıdığı: `TO_CUSTOMER`, `TO_MERCHANT`, `SPLIT_EQUAL`.
`installment`	Hesapta kullanılan taksit sayısı (tek çekimde `1`).
`method` / `posType` / `subType`	Quote'un çözümlendiği ödeme yöntemi ve POS yapılandırması.
`currency`	Para birimi.

Örnek yanıt (content)

{
  "baseAmount": 100,
  "commissionRate": 2.49,
  "commissionAmount": 2.49,
  "customerPays": 102.49,
  "merchantNet": 100,
  "applyType": "TO_CUSTOMER",
  "installment": 3,
  "method": "POS",
  "currency": "TRY"
}

Hatalar

Mesaj anahtarı	HTTP	Neden
`pos.amount.must.be.valid`	400	amount eksik ya da 0'dan büyük değil.
`pos.commission.not.found`	406	İstenen yöntem + taksit için tanımlı komisyon yok — bu durumda ödeme de reddedilir.

İsteği Dene

Önizleme modu — değerler kod örneklerini günceller, gerçek istek atılmaz.

Mock

methodamount*installmentcurrencysubType