Komisyon Önizleme
/partner/1.0/pos/commission/quotepayment: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).
Oran, karttan çekilen tutarın oranıdır. Komisyon müşteriye yansıtılıyorsa (TO_CUSTOMER) tutar brütleştirilir: customerPays = baseAmount / (1 − oran), commissionAmount = customerPays × oran, merchantNet = customerPays − commissionAmount (= baseAmount). TO_MERCHANT'ta customerPays = baseAmount; SPLIT_EQUAL'da customerPays = 2 × baseAmount / (2 − oran). Tüm tutarlar 2 haneye yuvarlanır.
İşletmenizde eşleşen bir POS yoksa önizleme hata vermez, %0 komisyonla döner.
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.
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 ve önizleme hata vermeden %0 komisyonla döner.
Ö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: POSPOSWALLETLOYALTYCASHFREE |
amountzorunlu | 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: DEFAULTDEFAULTBASICSTREAMINGCHARITYFOODFUEL |
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. |
{
"method": "POS",
"posType": "VIRTUAL",
"subType": "DEFAULT",
"installment": 3,
"applyType": "TO_CUSTOMER",
"commissionRate": 3.79,
"baseAmount": 100,
"commissionAmount": 3.94,
"customerPays": 103.94,
"merchantNet": 100,
"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. |
dealer.pos.installment.not.allowed | 406 | Bayi POS'unda bu taksit üst zincirde kapalı. |