3.3.Kart Bilgisi Saklama Servisi

v1/card/save

Kart saklama işlemlerinde OTP zorunluluğu var ve send otp servisinde oluşturulan kodu check_otp servisi ile doğrulama yapar.

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	Evet	CVV kodu
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ı
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.
user_gsm	string	Hayır	OTP doğrulama zorunlu ise send_otp servisinde otp_code gönderilen telefon numarası

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_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ü ; cc:Bireysel bc:Ticari dc:Debit
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
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_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"
}

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