2.1.Authenticate Servis

Auth

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.

https://api.paynet.com.tr/v1/paynetj/auth

İstek Parametreleri

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.

Dönüş Parametreleri

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ı

Request

{
  amount: "1037",
  agent_id: "12471", 
  pos_type: 5,
  add_commission: false,
  save_card : true:,
  user_unique_id:’DCFC03FA-F053-41BD-9DCA-E3178C84FB22’,
  card_owner_id:’d16eaa18-f00d-492d-868a-856412b7577d’,
  save_card_gsm_no:’5xxxxxxxxxx’
}

Response

{
  "session_id": "js_EAAAAHAql+krG7NbfmRg8N67QSm18/XMgCNNGM2rsM/3zt7t",
  "name": "ARENA BİLGİSAYAR SAN.TİC.A.Ş.",
  "tds_required": false,
  "expira_date": "2015-06-11T11:52:05.7659006+03:00",
  "obeject_Name": "paynetj_auth",
  "code": 0,
  "message": "Başarılı Islem"
}

Service Url

Sistem	URL
Canlı Sistem	https://api.paynet.com.tr/v1/paynetj/auth
Test Sistemi	https://pts-api.paynet.com.tr​​/v1/paynetj/auth