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[].number	transaction.installment_number
installments[].total	transaction.amount (karttan çekilecek tutar)
Sorgudaki transaction.amount	transaction.base_amount (satılan tutar)

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

PHP

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(
    channelReference: 'SIP-10234',
    amount: $option->total,
    baseAmount: '450.00',
    installmentNumber: $option->number,
    ip: $_SERVER['REMOTE_ADDR'],
    customer: $customer,
    card: $card,
));

Node.js

const bin = await client.retrieveBin({ bin: '54003600', amount: '450.00' });
const option = bin.installments[0]; // müşterinin seçtiği taksit

const payment = await client.regularPayment({
    channelReference: 'SIP-10234',
    amount: option.total,
    baseAmount: '450.00',
    installmentNumber: option.number,
    ip: req.ip,
    customer,
    card,
});

Python

from odemehub.request import RegularPayment, RetrieveBin

bin = client.retrieve_bin(RetrieveBin(bin="54003600", amount="450.00"))
option = bin.installments[0]  # müşterinin seçtiği taksit

payment = client.regular_payment(RegularPayment(
    channel_reference="SIP-10234",
    amount=option.total,
    base_amount="450.00",
    installment_number=option.number,
    ip=request.remote_addr,
    customer=customer,
    card=card,
))

Java

import com.odemehub.request.RegularPayment;
import com.odemehub.request.RetrieveBin;

var bin = client.retrieveBin(RetrieveBin.builder().bin("54003600").amount("450.00").build());
var option = bin.getInstallments().get(0); // müşterinin seçtiği taksit

var payment = client.regularPayment(RegularPayment.builder()
    .channelReference("SIP-10234")
    .amount(option.getTotal())
    .baseAmount("450.00")
    .installmentNumber(option.getNumber())
    .ip(request.getRemoteAddr())
    .customer(customer)
    .card(card)
    .build());

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-payment yanıtında conversion dolu döner:

"conversion": {
  "amount": "4985.56",
  "currency": "TRY",
  "rate": "49.855560"
}

Alan	Tip	Açıklama
amount	string	Karttan çekilen tutar, iki ondalıklı.
currency	string	Karttan çekilen para birimi.
rate	string	İ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.