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