# 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.  

{% 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](https://doc.paynet.com.tr/authentication#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](https://doc.paynet.com.tr/genel-bilgiler/taksit-kodlari)                                                                 |
| **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](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari)                                               |
| **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 %}