# 2.1.Authenticate Servis 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. {% hint style="success" %} {% endhint %} {% tabs %} {% tab title="İ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. | | {% endtab %} | | | | {% tab title="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ı](https://doc.paynet.com.tr/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) | | **message** | string | Sonuç mesajı | | {% endtab %} | | | {% tab title="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’ } ``` {% endtab %} {% tab title="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" } ``` {% endtab %} {% tab title="Service Url" %} | Sistem | URL | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/paynetj/auth](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/api.paynet.com.tr\[/v1/paynetj/auth)]\() | | **Test Sistemi** | [https://pts-api.paynet.com.tr​​\[/v1/paynetj/auth](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/pts-api.paynet.com.tr​​\[/v1/paynetj/auth)]\() | | {% endtab %} | | | {% endtabs %} | |