LogoLogo
GitHubFeedback Form
TR
TR
  • Başlangıç
  • Ön Hazırlıklar
    • Sandbox
    • Kimlik Doğrulama
      • HMACSHA256 Kimlik Doğrulama
    • Postman Collections
    • Live vs Sandbox
    • Eşleştirme
    • Limitler
  • Ödeme Metotları
    • Non-3DS
      • NON-3DS Entegrasyonu
        • Ödeme Oluşturma
        • Ödeme Sorgulama
    • 3DS
      • 3DS Entegrasyonu
        • 3DS Başlatma
        • 3DS Tamamlama
    • iyzico ile Öde (PWI)
      • PWI Entegrasyonu
        • PWI Başlatma
        • PWI Sorgulama
        • PWI Örnek Entegrasyon
    • Ödeme Formu (CheckoutForm)
      • CF Entegrasyonu
        • CF Başlatma
        • CF Sorgulama
        • CF Örnek Entegrasyon
  • Ürünler
    • Online Ödeme
    • Pazaryeri
      • Pazaryeri Entegrasyonu
        • Pazaryerlerinde Stopaj Uygulaması
        • Alt Üye
          • Alt Üye Güncelleme
          • Alt Üye Sorgulama
          • Alt Üye / Hak Ediş Güncelleme
        • Pazaryeri Ödemesi
        • Onay
    • Abonelik
      • Abonelik Entegrasyonu
        • Abonelik Ürünü
        • Ödeme Planı
        • Abonelik İşlemleri
        • Abone İşlemleri
    • Ceppos App2App
      • App2App Entegrasyonu
        • Kullanıcı Listeleme
        • Ödeme Başlatma
        • İptal / İade
        • Sorgulama
    • Korumalı Havale/EFT
      • Havale/EFT Entegrasyonu
        • Havale/EFT Başlatma
        • Havale/EFT Sorgulama
      • Havale/EFT SSS
    • iyzilink
      • iyzilink API
    • Alışveriş Kredisi
      • Alışveriş Kredisi Entegrasyonu
        • Alışveriş Kredisi Başlatma
        • Alışveriş Kredisi Sonucu Alma
        • Alışveriş Kredisi Örnek Entegrasyon
  • Ek Servisler
    • Kart Saklama
    • Raporlama Servisi
    • İptal ve İade
    • Webhook
    • SFTP
    • Mutabakat Dosyaları
    • Fraud Bildirimleri
    • Taksit ve BIN Sorgulama
    • iyzico Hesabına İade
    • Ödeme Sorgulama
    • İmza Yanıtının Doğrulanması
  • Platformlar
    • Woocommerce
    • Opencart
    • PrestaShop
    • Magento
    • IdeaSoft
    • Ticimax
    • T-Soft
    • Shopify
    • WIX
  • Ek Bilgiler
    • Hata Kodları
      • Banka Hata Kodları
    • Test Kartları
    • Entegrasyon Kontrol Listesi
    • iyzico Logo Paketi
Powered by GitBook
LogoLogo

Company

  • About
  • Career
  • Social
  • Youtube

Community

  • Github
  • Medium

Integration

  • Brand Guide
  • Solution Partners
  • Open Source

Contact

  • Contact Us
  • Support Center
On this page
  • Kullanıcı ve Kart Oluşturma
  • Kullanıcı ve Kart Oluşturma
  • Kullanıcıya Bağlı Başka Kart Oluşturma
  • Kullanıcıya Bağlı Başka Kart Oluşturma
  • Saklı Kartları Sorgulama
  • Saklı Kartları Sorgulama
  • Saklı Kart Silme
  • Saklı Kart Silme
  1. Ek Servisler

Kart Saklama

Kart Saklama özelliği, ödeme kartı bilgilerini yönetmek için güvenli ve kullanışlı bir çözüm sağlar, böylece kullanıcıların gelecekteki işlemler için kart ayrıntılarını güvenli bir şekilde kaydetmesine ve yönetmesine olanak tanır.

Kullanıcı ve Kart Oluşturma

Bu servisi kullanarak ödeme oluşturmadan, iyzico'da bir kullanıcı ve o kullanıcıya bağlı bir kart oluşturabilirsiniz. Servise gönderilmesi gereken parametreler şu şekildedir;

Kullanıcı ve Kart Oluşturma

POST https://api.iyzipay.com/cardstorage/card

Request Body

Name
Type
Description

cardAlias*

String

Saklı karta verilen isim.

email*

String

Saklı kart sahibinin email adresi.

expireYear*

String

Kartın üzerindeki yıl.

expireMonth*

String

Kartın üzerindeki ay.

cardNumber*

String

Kartın numarası.

cardHoldername*

String

Kartın üzerindeki isim.

externalId

String

Saklanmak istenen karta üye iş yeri tarafından verilen id.

locale

String

iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri

tr’dir.

conversationId

String

İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi

yapmak için kullanılabilir.

Kullanıcı ve Kart Oluşturma İsteğinden Dönen Cevap;

Parametre İsmi
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.

binNumber

string

Kartın ilk 6 hanesidir.

cardType

string

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu tipi. Geçerli değerler: CREDIT_CARD, DEBIT_CARD, PREPAID_CARD

cardAssociation

string

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu kuruluş. Geçerli değerler: VISA,

MASTER_CARD, AMERICA

N_EXPRESS

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

cardBankCode

integer

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

email

string

Saklanan kart üzerindeki email.

cardUserKey

string

Saklı kart kullanıcısının iyzico tarafından belirlenen değeri.

cardToken

string

Saklı kart kullanıcısına bağlı iyzico tarafından belirlenen saklı kart değeri.

cardAlias

string

Karta verilen isim.

carduserkey ve cardtoken değerlerini saklayabilirsiniz.

Kullanıcıya Bağlı Başka Kart Oluşturma

iyzico'da halihazırda oluşturulmuş bir kullanıcıya ikinci bir kart ekleyebilirsiniz. Servise gönderilmesi gereken parametreler şu şekildedir;

Kullanıcıya Bağlı Başka Kart Oluşturma

POST https://api.iyzipay.com/cardstorage/card

Request Body

Name
Type
Description

cardAlias*

String

Saklı karta verilen isim.

conversationId

String

İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi

yapmak için kullanılabilir.

locale

String

iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri

tr’dir.

cardUserKey*

String

Saklı kart kullanıcısının iyzico tarafından belirlenen değeri.

expireYear*

String

Kartın üzerindeki yıl.

expireMonth*

String

Kartın üzerindeki ay.

cardNumber*

String

Kartın numarası.

cardHoldername*

String

Kartın üzerindeki isim.

Kullanıcıya Bağlı Başka Kart Oluşturma İsteğinden Dönen Cevap;

Parametre İsmi
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.

binNumber

string

Kartın ilk 6 hanesidir.

cardType

string

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu tipi. Geçerli değerler: CREDIT_CARD, DEBIT_CARD, PREPAID_CARD

cardAssociation

string

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu kuruluş. Geçerli değerler: VISA, MASTER_CARD, AMERICAN_EXPRESS.

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

cardbankCode

integer

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

email

string

Saklanan kart üzerindeki email.

carduserKey

string

Saklı kart kullanıcısının iyzico tarafından belirlenen değeri.

cardtoken

string

Saklı kart kullanıcısına bağlı iyzico tarafından belirlenen saklı kart değeri.

cardalias

string

Karta verilen isim.

cardtoken değerini saklayabilirsiniz.

Saklı Kartları Sorgulama

iyzico'da bir kullanıcıya ait kartları sorgulayabilirsiniz. Servise gönderilmesi gereken parametreler şu şekildedir;

Saklı Kartları Sorgulama

POST https://api.iyzipay.com/cardstorage/cards

Request Body

Name
Type
Description

cardUserKey*

String

Saklı kart kullanıcısının iyzico tarafından belirlenen değeri.

conversationId

String

İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi

yapmak için kullanılabilir.

locale

String

iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri

tr’dir.

Saklı Kartları Sorgulama İsteğinden Dönen Cevap;

Parametre İsmi
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.

carduserKey

string

Saklı kart kullanıcısının iyzico tarafından belirlenen değeri.

binNumber(carddetails)

string

Kartın ilk 6 hanesidir.

cardType(carddetails)

string

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu tipi. Geçerli değerler:

CRE

DIT_CARD, D

E

BIT_CARD, PREPAID_CARD

cardAssociation(carddetails)

string

Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu kuruluş. Geçerli değerler:

VISA, MASTER_CARD, AMERICA

N_EXPRESS

cardFamily(carddetails)

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(carddetails)

string

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

cardbankCode(carddetails)

integer

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

cardtoken(carddetails)

string

Saklı kart kullanıcısına bağlı iyzico tarafından belirlnen saklı kart değeri.

cardalias(carddetails)

string

Karta verilen isim.

cardToken değerleri veritabanınızda saklı tutabilirsiniz ya da her defasında bu servisi kullanarak cardtoken değerlerini alabilirsiniz.

Saklı Kart Silme

iyzico'da oluşturulan bir kullanıcıya ait bir kartı silebilirsiniz. Servise gönderilmesi gereken parametreler şu şekildedir;

Saklı Kart Silme

DELETE https://api.iyzipay.com/cardstorage/card

Request Body

Name
Type
Description

cardToken*

String

Saklı kart kullanıcısına bağlı iyzico tarafından belirlnen saklı kart değeri.

conversationId

String

İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi

yapmak için kullanılabilir.

locale

String

iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri

tr’dir.

cardUserKey*

String

Saklı kart kullanıcısının iyzico tarafından belirlenen değeri.

Saklı Kart Silme İsteğinden Dönen Cevap;

Parametre İsmi
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.

Last updated 1 year ago