2.1.Authenticate Servis
Auth
Last updated
Auth
Last updated
Bu servis ödeme işlemini başlatan bir session oluşturur. Bu sessionin belirli bir süre içerisinde tamamlanması gerekir. Bu servis ile kredi kartından çekilecek tutarı, komisyon hesaplama yöntemi gibi parametreleri gönderebilirsiniz. Ana firma ile ilgili bazı bilgilerde bu servisden döner. Servis başarılı ise http 200 döner, hata durumunda http 200 dışındaki kodlar döner. Eğer ödeme ile birlikte ödemesi alınan kart numarasını Paynet sistemlerine güvenli olarak kaydetmek istiyorsanız save_card parametresini auth servisinde true yollayabilirsiniz. Kart saklama işlemini daha sonra da “Save Card Service (1.3 v1/paynetj/save_card )” ile tetikleyebilirsiniz.
Parametre İsmi
Tip
Zorunlu
Açıklama
amount
string
Evet
Ödeme tutarının yüz ile çarpılmış hali. “10.00 TL” => “1000” olarak gönderilmeli.
agent_id
string
Hayır
Bayi kodu: varsa işlemi yapan bayi kodu, paynet sistemindeki bayi kodu ya da firma sistemindeki cari kodu.
pos_type
string
Hayır
Paynet POS’larından işlem yapmak istiyorsanız, boş göndermelisiniz. Firma kendi pos’undan işlem yapmak istiyorsa pos_type:”1” olarak göndermelidir.
add_commission
bool
Hayır
True ise komisyon tutarı kredi kartından çekilecek tutara eklenir. False ise eklenmez. Default: False’dur.
reference_no
string
Hayır
İşleme verilen bir referans numarası.
ratio_code
string
Hayır
Paynet.com.tr yönetim ekranlarında “API oran tanımları” sayfasından tanımlayabileceğiniz oran tablolarının “oran kodunu” bu alanda gönderebilirsiniz. Gönderdiğiniz oran koduna ait oran tablosu üzerinden komisyon hesaplaması yapılır. Bu sayede API üzerinden istediğiniz oranlar ile işlem yapabilirsiniz.
domain
string
Evet
Mobil uygulamalarda işlem bir domain üzerinden olmadığından bu alanla uygulamanın ismini gönderebilirsiniz.
return_url
string
Hayır
3D’li işlemlerde 3D doğrulaması sonucu return_url adresine session_id ve token_id parmetreleri ile birlikte redirect yapılır. return_url parametresi verilmediği takdirde form tag’i arasına hidden input olarak session_id ve token_id değerleri post edilmiş olur.
save_card
bool
Hayır
Ödeme ile birlikte kredi kart numarasınında saklanması isteniyor ise save_card parametresi true yollayabilirsiniz
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. İlk kart saklama tamamlandıktan sonra Paynet tarafından bu kullanıcıya benzersiz bir değer atanır (Kredi kartından ödemenin alınması ( charge ) servisinden dönen card_owner_id değeri ). Bu değeri kendi sisteminizde kullanıcınız ile ilişkilendirerek saklamalısınız. Daha sonra bu kullanıcıya yapılan kart saklama işlemlerinde user_unique_id yerine Paynet tarafından verilen save_card_oid değişkenini kullanmalısınız.
car_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 bilgisi. Bir sonraki kart saklama ve karttan ödeme alma işlemlerinde servisleri bu değer kullanılır.
save_card_gsm_no
string
Hayır
Auth işleminde save_card değeri true ise ve kart saklama işleminde OTP kontrolu zorunlu ise bu parametreye OTP doğrulama kodunun gönderilmesi gereken telefon numarası girilmelidir. OTP zorunlu değil ise zorunlu değildir. OTP kullanma zorunluluğu Paynet ve Müşteri tarafından birlikte belirlenir.
Parametre İsmi
Tip
Açıklama
session_id
string
Başlatılan session’ın numarası. Diğer servislerde bu değişken kullanılır.
name
string
Ana firmanın adı
tds_required
bool
3D Secure işleminin zorunlu olup olmadığı, true ise zorunludur.
expire_date
string
Session'ın sona erme süresi
object_name
string
Dönen nesnenin ismi
code
string
Sonuç kodu 0 ise başarılıdır.Bknz. Dönüş Kodları
message
string
Sonuç mesajı
Sistem
URL
Canlı Sistem
https://api.paynet.com.tr/v1/paynetj/auth
Test Sistemi
https://pts-api.paynet.com.tr/v1/paynetj/auth