v1

latestOpenAPI 3.0.32026-07-232073105.4 KB
Kart Saklama

Kullanıcı ve Kart Oluşturma

Ödeme oluşturmadan, iyzico'da bir kullanıcı ve bu kullanıcıya bağlı bir kart kaydı oluşturabilirsiniz. Veya aynı endpoint üzerinden mevcut kullanıcıya yeni bir kart ekleyebilirsiniz. Bu noktada, istek parametreleri değişir. Her iki isteğin, request body ve json verilerine ulaşabilirsiniz;

post/cardstorage/card

Headers

Authorizationstring required

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Content-Typestring required

Content-Type değeri.

Request body

OR

Response

Başarılı yanıt

status'success' | 'failure'

Yapılan isteğin sonucunu bildirir.

localestring

Yanıt dili (tr/en).

systemTimeinteger

İşlem zamanı (epoch ms).

conversationIdstring

İstek ile eşleşen ID (varsa).

externalIdstring

İstekle iletilen externalId değeri.

emailstring

Saklanan kart üzerindeki email (yalnızca ilk varyantta dönebilir).

cardUserKeystring

Saklanan karta ait kullanıcı anahtarı. Tekrar ödeme tahsil etmek için kullanılır.

cardTokenstring

Saklı karta ait token. Tekrar ödeme tahsil etmek için kullanılır.

binNumberstring

Kartın ilk 8 hanesidir.

lastFourDigitsstring

Kartın son 4 hanesi.

cardType'CREDIT_CARD' | 'DEBIT_CARD' | 'PREPAID_CARD'

Kart tipi.

cardAssociation'VISA' | 'MASTER_CARD' | 'AMERICAN_EXPRESS'

Kart kuruluşu.

cardFamily'Bonus' | 'Axess' | 'World' | 'Maximum' | 'Paraf' | 'CardFinans'

Kart ailesi (yerel kartlarda döner).

cardAliasstring

Karta verilen isim.

cardBankCodeinteger

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu banka kodu.

cardBankNamestring

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu banka adı.