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.

https://api.paynet.com.tr/v1/card/save

İstek Parametreleri

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.

Dönüş Parametreleri

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	string	Kart numarasının ilk 6 son 4 tokenlanmış hali
card_bin	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ı

Request

{  
   "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"
}

Response

{  
   "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":"455508********8053",
   "card_bin":"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"
}

Service Url

Sistem	URL
Canlı Sistem	https://api.paynet.com.tr/v1/card/save
Test Sistemi	https://pts-api.paynet.com.tr/v1/card/save