# Finansallaştırma

Ön provizyonlu işlemlerde, kredi kartından ilgili tutarın veya ilgili tutardan az olarak finansallaştırmanın yapıldığı servistir. &#x20;

{% hint style="info" %}
Bu servis sadece ön provizyon türünde işlemlerin capture edilmesinde kullanılır.
{% endhint %}

{% hint style="warning" %}
Finansallaştırma servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [Bakınız](/authentication.md#secret-key)
{% endhint %}

{% hint style="success" %}
<https://api.paynet.com.tr/v1/transaction/capture>
{% endhint %}

{% tabs %}
{% tab title="İstek Parametreleri" %}

| Parametre İsmi    | Tip    | Zorunlu | Açıklama                                                                                                                                                                                |
| ----------------- | ------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id**      | string | Evet\*  | İşlemin şifrelenmiş id'si                                                                                                                                                               |
| **xact**          | string | Evet\*  | İşlemin id'si                                                                                                                                                                           |
| **reference\_no** | string | Evet\*  | İşlemin referans numarası                                                                                                                                                               |
| **amount**        | string | Hayır   | Finansallaştırmanın yapılmasının istenildiği tutar. Tutar 100 ile çarpılmış olmalıdır. “10.00 TL” => “1000” olarak gönderilmeli. Boş gönderilirse ön provizyon tutarının tamamı alınır. |
| {% endtab %}      |        |         |                                                                                                                                                                                         |

{% tab title="Dönüş Parametreleri" %}

| Parametre İsmi               | Tip      | Açıklama                                                                                                                                          |
| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id**                 | string   | İşlemin id’si                                                                                                                                     |
| **xact\_date**               | datetime | İşlemin tarihi                                                                                                                                    |
| **transaction\_type**        | char     | 1: satış 4:Finansallaştırma                                                                                                                       |
| **pos\_type**                | char     | 5: Paynet POS                                                                                                                                     |
| **is\_tds**                  | bool     | İşlem 3D’li ise true                                                                                                                              |
| **agent\_id**                | string   | İşlemi yapan bayinin Paynet cari hesap kodu                                                                                                       |
| **user\_id**                 | string   | İşlemi yapan kullanıcı                                                                                                                            |
| **email**                    | string   | Mail adresi                                                                                                                                       |
| **phone**                    | string   | Telefon bilgisi                                                                                                                                   |
| **bank\_id**                 | char     | Bankanın Paynet sistemindeki kodu                                                                                                                 |
| **instalment**               | int      | Taksit sayısı. [Bakınız](/genel-bilgiler/taksit-kodlari.md)                                                                                       |
| **ratio**                    | float    | Ödeme sırasında kullanılan oran.                                                                                                                  |
| **card\_no\_masked**         | string   | Maskeli kart numarası                                                                                                                             |
| **card\_holder**             | string   | Kart sahibi                                                                                                                                       |
| **amount**                   | decimal  | Kredi kartından çekilen tutar                                                                                                                     |
| **net\_amount**              | decimal  | Komisyon hariç tutar                                                                                                                              |
| **comission**                | decimal  | Komisyon tutarı                                                                                                                                   |
| **comission\_tax**           | decimal  | Komisyon vergisi                                                                                                                                  |
| **currency**                 | char     | Para birimi                                                                                                                                       |
| **authorization\_code**      | string   | Banka onay kodu                                                                                                                                   |
| **reference\_code**          | string   | Referans kodu                                                                                                                                     |
| **order\_id**                | string   | Banka sipariş no                                                                                                                                  |
| **is\_succeed**              | bool     | İşlem başarılı ise true. Eğer işlem başarılı ise http 200 ve is\_succeed true döner. Banka onay vermemiş ise http 200 ve is\_succedd false döner. |
| **paynet\_error\_id**        | string   | Paynet sistemi hata kodu                                                                                                                          |
| **paynet\_error\_message**   | string   | Paynet sistemi hata mesajı                                                                                                                        |
| **bank\_error\_id**          | string   | Banka sisteminin hata kodu                                                                                                                        |
| **bank\_error\_message**     | string   | Banka sisteminin hata mesajı                                                                                                                      |
| **bank\_error\_short\_desc** | string   | Banka sisteminin hata mesajı                                                                                                                      |
| **bank\_error\_long\_desc**  | string   | Banka sisteminin hata mesajı                                                                                                                      |
| **object\_name**             | string   | transaction                                                                                                                                       |
| **code**                     | string   | Sistem sonuç kodu. [Bakınız](/genel-bilgiler/hata-kodlari/doenues-kodlari.md)                                                                     |
| **message**                  | string   | Sistem mesajı                                                                                                                                     |
| {% endtab %}                 |          |                                                                                                                                                   |

{% tab title="Request" %}

```
{  
   "xact_id":"xk_EAAAANFhOW7SioFxO8LHPMruxp0hX3wE8NmJSmGUD*W3uISj"  ,
    "amount":"100"
}
```

{% endtab %}

{% tab title="Response" %}

```
{
"xact_id": "xk_EAAAAIO6j*mZ24gKFpk739cUeuL9P7oKyavBUO0Rbe7WKYXG",
"xact_date": "2016-04-08T10:27:22.0296925+03:00",
"transaction_type": 4,
"pos_type": 5,
"is_tds": true,
"agent_id": "20005",
"user_id": "cardholder",
"email": "",
"phone": "",
"bank_id": "AXSS",
"instalment": 3,
"ratio": 0.04,
"card_no_masked": "435508******4358",
"card_holder": "GJH",
"amount": 0,
"net_amount": 56.55,
"comission": 2.37,
"comission_tax": 0.43,
"currency": "TRY",
"authorization_code": "aut-8229",
"reference_code": "ref-8229",
"order_id": "order-8229",
"is_succeed": true,
"paynet_error_id": "",
"paynet_error_message": "",
"bank_error_id": "",
"bank_error_message": "",
"bank_error_short_desc": "",
"bank_error_long_desc": "",
"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/capture>     |
| **Test Sistemi** | <https://pts-api.paynet.com.tr/v1/transaction/capture> |
| {% endtab %}     |                                                        |
| {% endtabs %}    |                                                        |

{% hint style="info" %}
**xact\_id**, **xact** ve **reference\_no** alanlarından en az bir tanesi zorunludur.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://doc.paynet.com.tr/servisler/islem/finansallastirma.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
