> For the complete documentation index, see [llms.txt](https://doc.paynet.com.tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/1.5.kredi-kartindan-oedeme-alinmasi-v1-transaction-charge.md). # 1.5.Kredi Kartından Ödeme Alınması 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. {% hint style="success" %} {% endhint %} {% tabs %} {% tab title="İ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 | | {% endtab %} | | | | {% tab title="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. | | {% endtab %} | | | {% tab title="Request" %} ``` { "session_id":"js_EAAAACbRzo74tNbO56EdJtHWkJVbbpGnwpPHtzweU2A0LzPu", "token_id":"jt_EAAAAIEOepBMwb1HKJddqx7r9NsyxCFd4cwglcnWsP36nZd+RyhJjac485Io+F3GBFVzflD0ySWTvhhRdCMRM8y/19g=", "reference_no":"sip123456", "transaction_type":1 } ``` {% endtab %} {% tab title="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" } ``` {% endtab %} {% tab title="Service Url" %} | Sistem | URL | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/transaction/charge](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/api.paynet.com.tr\[/v1/transaction/charge)]\() | | **Test Sistemi** | [https://pts-api.paynet.com.tr​​\[/v1/transaction/charge](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/pts-api.paynet.com.tr​​\[/v1/transaction/charge)]\() | | {% endtab %} | | | {% endtabs %} | | {% hint style="info" %} 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. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/1.5.kredi-kartindan-oedeme-alinmasi-v1-transaction-charge.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.