Puan Sorgulama :
Puan Kullanımı :
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);
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. |