1.5.Kredi Kartından Ödeme Alınması

v1/transaction/charge

Token bilgisi oluşturulduktan sonra Server-side’da kredi kartından ödeme işlemi onaylanmalı, bu aşamaya kadar yapılan işlemlerde kredi kartından ödeme alınmaz. Ödeme charge servisinden sonra kredi kartından tahsil edilir. Servisi kullanabilmek için secret key ile authorization yapmalısınız. Aynı zamanda bu servis sadece static bir ip adresi üzerinden kullanılabilir. Mobil uygulamalar üzerinden secret key’inizi kullanarak bu servisi kullanamazsınız.

Eğer kart saklama işlemi başarılı ise charge sonrası “is_save_card_succeed”: true şeklinde döner, hata durumunda “save_card_result_message” kart saklama işleminin neden hatalı olduğunu döner. user_unique_id değişkeninde kullanıcının sizin sisteminizdeki benzersiz değeri, card_owner_id ise Paynet tarafından verilen o kullanıcıya ait benzersiz değer. card_owner_id değerini kendi sisteminizde kullanıcı ile ilişkilendirerek saklamalısınız. O kullanıcının saklı kartlarına card_owner_id değeri üzerinden kart listeleme servisinden ulaşabilirsiniz.

https://api.paynet.com.tr/v1/transaction/charge

Parametre İsmi

Tip

Zorunlu

Açıklama

session_id

string

Evet

Auth servisiyle ilgili alınan session bilgisi

token_id

string

Evet

Create_token ile alınan token bilgisi.

reference_no

string

Hayır

Ödeme işleminin ilişkili olduğu referans numarası. Örneğin sipariş numarası.

transaction_type

string

Hayır

Parametre İsmi

Tip

Açıklama

string

Tekil Paynet işlem id'si

xact_id

string

Paynet işlem id'nin hash değeri

xact_date

datetime

İşlemin tarihi

transaction_type

char(1)

Satış ya da ön provizyon. 1 satış, 3 ön provizyon. Varsayılan satış işlemidir.

pos_type

int

Pos tipi

is_tds

bool

True ise 3D'siz işlem yapılamaz. False ise 3D'li veya 3D'siz işlem yapılabilir.

agent_id

string

Bayi kodu

user_id

string

Kullanıcı kodu

email

string

Mail adresi

phone

string

Telefon bilgisi

bank_id

string

Banka kodu

bank_name

string

Banka adı

instalment

int

İşlemin kaç taksit yapılacağı. Değer gönderilmezse tek çekim uygulanır.

ratio

float

İşlem komisyon oranı

card_no_masked

string

Maskeli kart bilgisi

card_holder

string

Kart sahibinin bilgisi

amount

decimal

Brüt işlem tutarı

net_amount

decimal

Komisyon hariç tutar

comission

decimal

Komisyon tutarı

comission_tax

decimal

Komisyon vergisi

currency

string

Para birimi

authorization_code

string

Onay kodu

reference_code

string

Referans kodu

order_id

string

Sipariş numarası

is_succeed

bool

işlemin başarılı ya başarısız olduğu bilgisi. true ise ilgili karttan tutar tahsil edilmiş demektir.

paynet_error_id

string

Paynet hata kodu

paynet_error_message

string

Paynet hata mesajı

bank_error_id

string

Bankadan bildirilen hata kodu

bank_error_message

string

Bankadan bildirilen hata mesajı

bank_error_short_desc

string

Bankadan bildirilen hata mesajı

bank_error_long_desc

string

Bankadan bildirilen hata mesajı

agent_reference_no

string

Request sırasında gönderilen referans kodu

campaign_url

string

Bazı kart progamlarında + taksit ve taksit erteleme seçimi işlem sonrası başka bir uygulamada seçilebiliyor.

end_user_comission

decimal

ratio_code kullanımında komisyon değeri

end_user_ratio

float

ratio_code kullanımında komisyon oranı

ratio_code

string

Oran kodu

ratio_code_method

string

Oran kodu methodu

is_save_card_succeed

bool

Kart saklama işlemi yapılıyorsa kart saklama sonucu

save_card_result_message

string

Kart saklama mesajı

user_unique_id

string

Müşterinizin benzersiz numarası

card_owner_id

string

Kart saklamada bir sonraki sefer kullanılacak id

object_name

string

Dönen cevabın nesne adı

code

string

İşlemin cevap kodu 0 ise işlem başarılıdır.

message

string

İşlemin cevap koduna göre mesaj barındırır.

{  
   "session_id":"js_EAAAACbRzo74tNbO56EdJtHWkJVbbpGnwpPHtzweU2A0LzPu",
   "token_id":"jt_EAAAAIEOepBMwb1HKJddqx7r9NsyxCFd4cwglcnWsP36nZd+RyhJjac485Io+F3GBFVzflD0ySWTvhhRdCMRM8y/19g=",
   "reference_no":"sip123456",
   "transaction_type":1
}

{
    "id": 2038219,
    "xact_id": "xk_EAAAAIbSIhPJEDLcacVaeEbEfE8hrWt6arVigzKVOXX7FT*V",
    "xact_date": "2017-07-14T13:48:20.5428782+03:00",
    "transaction_type": 1,
    "pos_type": 5,
    "is_tds": false,
    "agent_id": "10031",
    "user_id": "PaynetApi",
    "email": “”,
    "phone": “”,
    "bank_id": "AXSS",
    "bank_name": "Axess",
    "instalment": 0,
    "ratio": 0.025,
    "card_no_masked": "434678******0002",
    "card_holder": "onur ozdemir",
    "amount": 100,
    "net_amount": 97.5,
    "comission": 2.5,
    "comission_tax": 0,
    "currency": "TRY",
    "authorization_code": "aut-4881",
    "reference_code": "ref-4881",
    "order_id": "order-4881",
    "is_succeed": true,
    "paynet_error_id": "",
    "paynet_error_message": "",
    "bank_error_id": "",
    "bank_error_message": "",
    "bank_error_short_desc": "",
    "bank_error_long_desc": "",
    "agent_reference_no": "",
    "campaign_url": "",
    "end_user_comission": 0,
    "end_user_ratio": 0,
    "ratio_code": "",
    "ratio_code_method": "",
    "is_save_card_succeed": true,
    "save_card_result_message": "Kart saklama islemi basarili",
    "user_unique_id": "DCFC03FA-F053-41BD-9DCA-E3178C84FB22",
    "card_owner_id": "f4dabd79-5b7e-40bd-84d5-54058242dfa0",
    "object_name": "transaction",
    "code": 0,
    "message": "Başarılı İşlem"
}

Charge işlemi sırasında eğer connection timeout ya da execution time out gibi sebeplerden dolayı cevap alamıyorsanız, aynı session id ile cevap alana kadar işleme devam edebilirsiniz. Sistem aynı session id ile daha önceden başarılı bir işlem var ise o işlemi döndürür. Bu durumda sonuç kodu 0 yerine 100 döner, sonuç mesajı da “Önceki Başarılı İşlem” şeklinde döner.

Previous1.4.Kart Bilgilerini Yollama Next2.Saklanmış Kart Verisi ile Ödeme Alma

Last updated 5 years ago