Puan Sorgulama & Kullanım

Puan Sorgulama :

Puan Kullanımı :

Puan Sorgulama

Bu servisi kullanarak istediğiniz bir kartın puan durumunu sorgulayabilirsiniz.

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre ismi Tip Zorunluluk Açıklama
cardHoldername string evet Kartın üzerindeki isim.
cardNumber string evet Kartın numarası.
expireMonth string evet Kartın üzerindeki ay.
expireYear string evet Kartın üzerindeki yıl.
locale string hayır iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
conversationId string hayır İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.
currency string evet para birimi default TL olarak belirlenmiştir. Diğer değerler ise USD, EUR, GBP olmak üzere, farklı para birimleri ile alışverişin hesabınıza tanımlandığından emin olunuz.

Servisten dönen parametreler şu şekildedir:

Parametre ismi Tip Açıklama
status string Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner.
errorCode string İşlem hatalıysa, bu hataya dair belirtilen koddur.
errorMessage string İşlem hatalıysa, bu hataya dair belirtilen mesajdır. Locale parametresine göre dil desteği sunar.
errorGroup string İşlem hatalıysa, bu hataya dair belirtilen gruptur.
locale string İstekte belirtilen locale değeri geri dönülür, varsayılan değeri trdir.
systemTime integer Dönen sonucun o anki unix timestamp değeridir.
conversationId string İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.
cardFamily string Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu aile. Geçerli değerler: Bonus, Axess, World, Maximum, Paraf, CardFinans.
cardBankName string Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu banka adı.
points Decimal kartın puan miktarı.
amount Decimal kartın kullanılabilir puan miktarı.
$request = new \Iyzipay\Request\RetrieveLoyaltyRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setCurrency(\Iyzipay\Model\Currency::TL);

$paymentCard = new \Iyzipay\Model\PaymentCard();
$paymentCard->setCardHolderName("John Doe");
$paymentCard->setCardNumber("5451030000000000");
$paymentCard->setExpireMonth("12");
$paymentCard->setExpireYear("2030");
$paymentCard->setCvc("123");
$request->setPaymentCard($paymentCard);

$loyalty = \Iyzipay\Model\Loyalty::retrieve($request, Config::options());
LoyaltyInquireRequest request = new LoyaltyInquireRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setCurrency(Currency.TRY.name());

LoyaltyPaymentCard paymentCard = new LoyaltyPaymentCard();
paymentCard.setCardHolderName("John Doe");
paymentCard.setCardNumber("5451030000000000");
paymentCard.setExpireMonth("09");
paymentCard.setExpireYear("2023");
paymentCard.setCvc("123");
request.setPaymentCard(paymentCard);
LoyaltyInquire loyalty = LoyaltyInquire.create(request, options);

Örnek Kodlar

Puan Kullanımı

API Ödeme ve 3D Ödeme entegrasyonu sırasında aşağıda belirtilen 2 parametreyi ekleyerek, istenilen karttan puan kullanımı sağlayabilirsiniz.

Parametre ismi Tip Zorunluluk Açıklama
rewardAmount BigDecimal evet Ödeme işleminde kullanılmak istenen puan miktarı burada gönderilmelidir.
rewardUsage Integer evet Ödeme işleminin puan kullanılan bir işlem olduğunu belirtir. Eğer puan kullanılmak isteniyor ise 1, değil ise 0 gönderilmelidir.

Örnek Kodlar