URL
Saklı kartları aramak için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.
| HTTP Metod | URL |
|---|---|
GET |
/payment/v1/cards |
İstek Parametreleri
Saklı kartları arama işlemi gerçekleştirmek için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.
| Parametre Adı | Tipi | Zorunlu | Açıklama |
|---|---|---|---|
cardId | long | Hayır | Kart kimliği. |
merchantId | long | Hayır | Üye işyeri filtresi; kimlik doğrulanan header esas alınır. |
subMerchantId | long | Hayır | Alt üye işyeri kimliği. |
buyerId | long | Hayır | Alıcı kimliği. |
externalCustomerId | string | Hayır | Üye işyeri sistemindeki müşteri kimliği. |
partnerId | long | Hayır | Partner kimliği. |
walletId | long | Hayır | Cüzdan kimliği. |
cardAlias |
string |
Hayır | Kart ismi |
cardBrand |
string |
Hayır | Kart markası |
cardType |
string |
Hayır | Kart türü. CREDIT_CARD, DEBIT_CARD ya da PREPAID_CARD |
cardUserKey |
string |
Hayır | Kart kullanıcı anahtarı |
cardToken |
string |
Hayır | Kart tokenı? |
cardBankName |
string |
Hayır | Banka ismi |
cardAssociation |
string |
Hayır | Kart kuruluşu. VISA, MASTER_CARD, AMEX ya da TROY |
page |
integer |
Hayır | Sıfır tabanlı sayfa numarası; minimum 0, varsayılan 0. |
size |
integer |
Hayır | Sayfa boyutu; minimum 1, varsayılan 10. |
Dönüş Parametreleri
| Parametre Adı | Tipi | Açıklama |
|---|---|---|
cardNumber | string | Maskelenmiş kart numarası. |
binNumber |
string |
Bin numarasi |
lastFourDigits |
string |
Kartın son 4 hanesi |
expireYear |
string |
Kart son kullanma yılı |
expireMonth |
string |
Kart son kullanma ayı |
cardHolderName |
string |
Kart üzerindeki isim |
cardUserKey |
string |
Kart kullanıcı anahtarı |
cardToken |
string |
Kart tokenı? |
cardAlias |
string |
Kart ismi |
cardType |
CardType |
Kart türü. CREDIT_CARD, DEBIT_CARD ya da PREPAID_CARD bknz. Kart Tipleri |
cardAssociation |
CardAssociation |
Kart kuruluşu. VISA, MASTER_CARD, AMEX ya da TROY bknz. Kart Kuruluşları |
cardBrand |
string |
Banka markası |
cardBankName |
string |
Banka ismi |
cardBankId |
number |
Kart bankasının ID değeri |
Örnek Kodlar
Açık kaynak kodlu ÖderoPay API client'larındaki örnek kodları inceleyebilirsiniz
- .NET: https://github.com/TokenPayEng/tokenpay-dotnet-client/blob/master/Samples/PaymentSample.cs
- PHP: https://github.com/TokenPayEng/tokenpay-php-client/blob/master/samples/search_stored_cards.php
- Java: https://github.com/TokenPayEng/tokenpay-java-client/blob/master/src/test/java/tr/com/tokenpay/sample/PaymentSample.java
- Node.js: https://github.com/TokenPayEng/tokenpay-node-client/blob/master/samples/payment/SearchStoredCards.js
Kart Aktarımı
Taşınan kayıtlı kartlar POST /payment/v1/cards ile aktarılır. JSON gövdesi cardHolderName, cardNumber, expireYear, expireMonth, cardAlias, onMerchantCardUserKey ve onMerchantCardToken alanlarını destekler. Başarılı yanıt 204 No Content'tir.