Kart Bilgisi Saklama

v1/card/save

Paynet üzerinden ödeme almadan kart bilgilerini kaydetmenizi sağlayan servistir. Kart saklama servisini kullanırken aşağıdaki maddeler dikkat etmeniz gerekmektedir.

  • İşlem sırasında kartı saklamak istiyorsanız müşterinizin benzersiz (unique) bir bilgisine ihtiyacınız vardır ( userid, gsm no, e_mail vs..).

  • İlk defa kart saklama işlemi yaptığınızda user_unique_id parametresinde bu değeri göndermelisiniz.

  • Daha sonra Paynet sizin müşterinize ait benzersiz card_owner_id üretir.

  • Sizin de kendi sisteminizde kendi müşteri benzersiz değeriniz ile card_owner_id değerini ilişkilendirip saklamanız gerekir.

  • Bundan sonraki tüm işlemlerinizde card_owner_id'yi kullanacaksınız. Bir müşterinize bir kere kart saklama işlemi yaptıktan sonra kart saklama ya da saklı karttan işlem alma isteklerinde artık card_owner_id parametresi kullanacaksınız.

Bu servisi kullanabilmeniz için secret_key ile basic authentication yapmalısınız. bnkz.

İstek Parametreleri
Dönüş Parametreleri
Request
Response
Service Url

Parametre İsmi

Tip

Zorunlu

Açıklama

card_desc

string

Evet

Saklı karta verilen isim

card_holder

string

Evet

Kart üzerindeki isim

card_number

string

Evet

Kart numarası

expire_month

string

Evet

Kart üzerindeki ay

expire_year

string

Evet

Kart üzerindeki yıl

cvv

string

Hayır

CVV kodu. CVV kodu gönderirseniz kart saklama sırasında bankadan kartın doğruluğunu kontrol etmek için 1 TL'lik ön provizyon alınıp iptal edilecektir.

user_unique_id

string

Hayır

Üye iş yeri tarafından verilen kullanıcıya özgü benzersiz id. İlk defa kart saklama yapılıyorsa zorunlu.

card_owner_id

string

Hayır

İlk defa kart saklama yapıldıktan sonra, Paynet tarafından user_unique_id’ye göre oluşturulan kart sahibinin benzersiz değeri. Bir sonraki kart saklama servisleri bu benzersiz değer üzerinden yapilir.

otp_code

string

Hayır

Son kullanıcının send_otp servisinde parametre olarak gönderilen numarası.

Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz.

otp_session_id

string

Hayır

OTP ile ilişkilendirilecek benzersiz değer. Bu değer ile saklanacak kart bilgisi ilişkilendirmesi yapılır. Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz.

user_gsm

string

Hayır

OTP doğrulama zorunlu ise send_otp servisinde otp_code gönderilen telefon numarası.Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz.

Parametre İsmi

Tip

Açıklama

card_desc

string

Saklı kart bilgisine verilen isim

card_hash

string

Kart numarasının hashlenmiş değeri

card_no_masked

string

Kart numarasının ilk 6 son 4 tokenlanmış hali

card_bin_no

string

Kartın ilk 6 hanesi

card_type

string

Kart türü. Bknz.

card_bank_name

string

Kartın banka adı ( Bonus,Axess,vs)

card_logo_url

string

Kartın logo görseli

card_brand_name

string

VISA,MASTERCARD,AMEX

card_owner_id

string

Kart sahibinin Paynet'in ürettiği benzersiz değeri

user_unique_id

string

Üye iş yeri tarafından verilen kullanıcıya özgü benzersiz id. İlk saklamada gönderilen değer.

object_name

string

Dönüş yapılan API’nin nesne adı

code

string

Dönüş sonucunun kodu. Bknz

message

string

Dönüş sonuç kodunun açıklaması

{
"user_gsm":"5xxxyyzz",
"otp_session_id":"otp_session_id",
"otp_code":"ART2",
"card_desc":"Kart aciklamasi",
"card_holder":"Onur Ozdemir",
"card_number":"435508xxxxxxxx",
"expire_month":"12",
"expire_year":"18",
"cvv":"000",
"user_unique_id":"benzersiz deger"
}
{
"card_owner_id":"abc45adc20-91ba-4a29-a599-0eb18177247e",
"user_unique_id":"benzersiz deger",
"card_desc":"test",
"card_hash":"abcdef-8014-435e-8bcc-daf4592f3431",
"card_no_masked":"455508********8053",
"card_bin_no":"435508",
"card_type":"cc",
"card_bank_name":"WorldCard",
"card_logo_url":"https://pts-statics.paynet.com.tr/img/banklogo/small/AXSS.png",
"card_brand_name":"VISA",
"object_name":"card_save",
"code":0,
"message":"Başarılı İşlem"
}