Paynet API
Search…
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
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ı
1
{
2
"user_gsm":"5xxxyyzz",
3
"otp_session_id":"otp_session_id",
4
"otp_code":"ART2",
5
"card_desc":"Kart aciklamasi",
6
"card_holder":"Onur Ozdemir",
7
"card_number":"435508xxxxxxxx",
8
"expire_month":"12",
9
"expire_year":"18",
10
"cvv":"000",
11
"user_unique_id":"benzersiz deger"
12
}
Copied!
1
{
2
"card_owner_id":"abc45adc20-91ba-4a29-a599-0eb18177247e",
3
"user_unique_id":"benzersiz deger",
4
"card_desc":"test",
5
"card_hash":"abcdef-8014-435e-8bcc-daf4592f3431",
6
"card_no":"455508********8053",
7
"card_bin":"435508",
8
"card_type":"cc",
9
"card_bank_name":"WorldCard",
10
"card_logo_url":"https://pts-statics.paynet.com.tr/img/banklogo/small/AXSS.png",
11
"card_brand_name":"VISA",
12
"object_name":"card_save",
13
"code":0,
14
"message":"Başarılı İşlem"
15
}
Copied!
Sistem
URL
Canlı Sistem
https://api.paynet.com.tr/v1/card/save
Test Sistemi
https://pts-api.paynet.com.tr/v1/card/save
Last modified 1yr ago
Copy link