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

İstek Parametreleri

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	1

Dönüş Parametreleri

Parametre İsmi	Tip	Açıklama
id	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.

Request

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

Response

{
    "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"
}

Service Url

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

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.