Ana içeriğe geç

Taksit ve Kur Çevirisi

Taksit​

Taksit seçenekleri retrieve-bin ile alınır ve ödeme isteğinde üç alanla gönderilir.

retrieve-bin yanıtıÖdeme isteği alanı
installments[].numbertransaction.installment_number
installments[].totaltransaction.amount (karttan çekilecek tutar)
Sorgudaki transaction.amounttransaction.base_amount (satılan tutar)
  • amount ve base_amount sıfırdan büyük olmalıdır; amount en fazla 10000000.00 olabilir. base_amount, amount değerinden büyük olamaz. Gönderilmezse amount ile aynı kabul edilir.
  • Taksit yalnızca Türk Lirası için geçerlidir. currency TRY değilse ya da ödeme kur çevirisiyle TRY dışında çekilecekse installment_number 1 olmalıdır ve retrieve-bin boş installments döner.
  • retrieve-bin ve ödeme isteğinde payment_provider_token birlikte gönderilmeli ya da birlikte gönderilmemelidir; gönderilmediğinde ikisi de aynı hesap seçimini kullanır.
  • retrieve-bin result.successful: false dönebilir. Bu durumda installments boş olabilir.
not

Örneklerdeki $client / client nesnesinin kurulumu: İstemciyi Kurmak.

use Gurmehub\Odemehub\Request\{RegularPayment, RetrieveBin};

$bin = $client->retrieveBin(new RetrieveBin(bin: '54003600', amount: '450.00'));
$option = $bin->installments[0]; // müşterinin seçtiği taksit

$payment = $client->regularPayment(new RegularPayment(
reference: 'SIP-10234',
amount: $option->total,
baseAmount: '450.00',
installmentNumber: $option->number,
ip: $_SERVER['REMOTE_ADDR'],
customer: $customer,
card: $card,
));

Taksit sınırı​

Sipariş, abonelik ve ödeme linkinde taksidi ödeyen, checkout_url adresindeki ödeme sayfasında seçer. Bazı ürünlerde yasal ya da kategoriye bağlı bir taksit sınırı vardır (örneğin bir kategoride bireysel kartta yalnızca tek çekim, ticari kartta en fazla 3 taksit). Bu sınır create-order, create-subscription ve create-payment-link isteklerinde max_installments ile verilir:

"max_installments": { "individual": 1, "commercial": 3 }
AnahtarTipAçıklama
individualinteger | nullBireysel kartlarda sunulacak en yüksek taksit sayısı, 1–12.
commercialinteger | nullTicari (şirket) kartlarda sunulacak en yüksek taksit sayısı, 1–12.
  • 1 yalnızca tek çekim demektir; null o kart tipi için sınır koymaz. max_installments gönderilmezse sınır yoktur.
  • Kartın bireysel mi ticari mi olduğu bankadan sorgulanır. Kart tipi bilinmiyorsa kart bireysel sayılır.
  • Ödeme sayfası girilen kartın taksit seçeneklerini o kart tipinin sınırına kadar gösterir ve ödeyene bazı ürünlerde daha az taksit yapılabildiğini kısa bir notla bildirir. Sınırın üstünde bir taksitle ödeme alınmaz.
  • update-order, update-subscription ve update-payment-link ile gönderilen max_installments kayıtlı sınırın yerine geçer; gönderilmezse sınır değişmez. null ya da { "individual": null, "commercial": null } sınırı kaldırır.
  • Sınır, yanıtlarda sipariş, abonelik ve ödeme linki nesnesinin max_installments alanında döner.

secure-payment ve regular-payment isteklerinde bu alan yoktur: taksit sayısını transaction.installment_number ile siz gönderirsiniz, sınırı da kendi ödeme formunuzda uygularsınız.

Kur çevirisi​

Çalışma alanı panelde bir para birimi için kur çevirisi kuralı tanımladıysa, o para biriminde gönderilen ödeme karttan kuralın para biriminde çekilir. İstekte değişen bir alan yoktur.

Bu durumda ödeme yanıtında ve retrieve-payments yanıtında conversion dolu döner:

"conversion": {
"amount": "4985.56",
"currency": "TRY",
"rate": "49.855560"
}
AlanTipAçıklama
amountstringKarttan çekilen tutar, iki ondalıklı.
currencystringKarttan çekilen para birimi.
ratestringİstekteki para biriminin bir biriminin karşılığı, altı ondalıklı.
  • Çevrilmeyen ödemede conversion null'dır.
  • İade tutarı (refund-payment amount) conversion.currency cinsindendir.
  • Ödeme hesabının desteklemesi gereken para birimi, karttan çekilecek para birimidir.
  • Kur alınamadığında ödeme alınmaz: 422, transaction.currency, Güncel kur bilgisi alınamadığı için ödeme şu an alınamıyor.