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.
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. |
Last updated