Giriş: Müşterilerinizin daha önce kaydettiği kredi kartları ile hızlı ve güvenli ödeme almanızı sağlayan PayTR Kayıtlı Karttan Ödeme sistemi, hem kullanıcı deneyimini iyileştirir hem de ödeme sücretlerini azaltır. Bu makalede, PayTR CAPI List servisinden dönen require_cvv
, utoken
ve ctoken
bilgilerinin nasıl kullanılacağı adım adım anlatılmıştır.
Adım 1: Kullanıcının Kayıtlı Kart Listesini Alın
-
CAPI List servisi ile kullanıcıya ait kayıtlı kart bilgileri alınır.
-
Bu kartlar web/mobil uygulamanızda listelenir.
Adım 2: Kart Seçimi ve CVV Kontrolü
-
Kullanıcı kartlardan birini seçer.
-
Seçilen karta ait
require_cvv
değeri kontrol edilir. -
require_cvv = 1
ise, kullanıcıdan CVV kodu girmesi istenir.
Adım 3: Ödeme Talebi Gönderimi
-
Kullanıcının seçtiği kartın
ctoken
bilgisi ve kullanıcınınutoken
bilgisi, ödeme talebine eklenir.
Token Üretiminde Kullanılacak Veriler:
-
merchant_id
: PayTR Mağaza Numaranız -
user_ip
: Müşterinin anlık IP adresi -
merchant_oid
: Mağaza sipariş numarası -
email
: Müşteri e-posta adresi -
payment_amount
: Sipariş tutarı (100 ile çarpılmış hali) -
payment_type
: card -
installment_count
: Taksit sayısı (0-12 aralığı) -
currency
: TL, EUR, USD vb. -
test_mode
: 0 veya 1 -
non_3d
: 0 veya 1 -
merchant_salt
vemerchant_key
: Mağazaya özel bilgiler
POST Edilecek Ek Alanlar:
-
require_cvv
: Seçilen karta göre 1 veya 0 -
ctoken
: Seçilen kartın ctokenı -
utoken
: Kullanıcıya ait utoken
Gönderilecek POST REQUEST Alanları:
-
Tüm zorunlu bilgiler ve ek olarak:
-
merchant_ok_url
-
merchant_fail_url
-
user_name
,user_address
,user_phone
-
user_basket
(JSON format) -
debug_on
-
CVV Zorunluluğu Örneği:
if($require_cvv == 1){
echo '';
}
Önemli Uyarılar:
-
require_cvv=1
ise CVV mutlaka girişi istenmelidir. -
ctoken
veutoken
bilgilerinin doğruluğu kesinlikle doğrulanmalıdır. -
Test ortamında
test_mode=1
kullanılmalıdır. -
Ödeme sonucunda Bildirim URL'ye yanıt "OK" olarak verilmelidir.
Avantajlar:
-
Kullanıcı deneyimi artar.
-
Ödeme hızı katlanır.
-
Kart bilgilerinin güvenli saklanması sağlanır.
Sonuç: PayTR ile Kısa Yoldan Kredi Kartıyla Ödeme almak artık çok kolay! Siz de hemen Eka Sunucu PayTR Entegrasyon Rehberi sayfasından detaylı bilgilere erişebilir ve entegre olmaya başlayabilirsiniz.