# Oran Tanımlama

Bir oran tipine oranların tanımını yapmayı, bu oran tipi için taksit veya banka bloklamayı sağlayan servistir.

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

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

| Parametre İsmi  | Tip    | Zorunlu | Açıklama                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------- | ------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ratio\_code** | string | Evet    | Oran tanımı yapmak istediğiniz oran tipine ait kod                                                                                                                                                                                                                                                                                                                                                                        |
| **card\_type**  | string | Hayır   | Kart türü (cc: Kredi Kartı, dc: Debit Kart, bc: Ticari Kart)                                                                                                                                                                                                                                                                                                                                                              |
| **banks**       | dizi   | Evet    | Oran tanımlarının yapılacağı bankaları tutan dizi. [Bakınız](https://doc.paynet.com.tr/genel-bilgiler/banka-kodlari)                                                                                                                                                                                                                                                                                                      |
| =>bank\_id      | char   | Evet    | Tanımların yapılacağı bankaları temsil eden 4 karakterli kod                                                                                                                                                                                                                                                                                                                                                              |
| =>is\_blocked   | bool   | Hayır   | true/false, Default: false. Banka veya taksitin bloklu olup olmadığına dair, "banks" veya "instalments" dizilerindeki nesnelere eklenebilir.                                                                                                                                                                                                                                                                              |
| =>instalments   | dizi   | Hayır   | "banks" dizisinin altındaki her nesne için taksitlere ait bilgileri tutan dizilerdir. Bir banka bloklanacaksa bu banka için "instalments" dizisi göndermeye gerek yok.                                                                                                                                                                                                                                                    |
| ->instalment    | int    | Evet    | Bloklanacak veya oran tanımı yapılacak taksite ait numara. [Bknz.](https://doc.paynet.com.tr/genel-bilgiler/taksit-kodlari)                                                                                                                                                                                                                                                                                               |
| ->is\_blocked   | bool   | Hayır   | true/false, Default: false. Banka veya taksitin bloklu olup olmadığına dair, "banks" veya "instalments" dizilerindeki nesnelere eklenebilir.                                                                                                                                                                                                                                                                              |
| ->ratio         | float  | Hayır   | Default: 0. Tanımların yapılacağı oran tipinin, oran hesaplama yöntemine göre belli aralıklarda gönderilmesi gereken orandır. Oran hesaplama yönetimi "Kümülatif" olan oran tiplerinde minimum -0.20, maksimum 0.20 olabilir. Oran hesaplama yönetimi "Net" olan oran tiplerinde minimum 0, maksimum 0.20 olabilir. Taksit bloklanacaksa veya oran "0" olarak kaydedilecekse bu parametrenin gönderilmesine gerek yoktur. |
| {% endtab %}    |        |         |                                                                                                                                                                                                                                                                                                                                                                                                                           |

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

| Parametre İsmi   | Tip    | Açıklama                                                                                               |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------ |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı "ratio\_define"                                                        |
| **code**         | string | Dönüş sonucunun kodu. [Bakınız](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message**      | string | Dönüş sonuç kodunun açıklaması                                                                         |
| {% endtab %}     |        |                                                                                                        |

{% tab title="Request" %}

```
  
  {
"ratio_code":"JR***MSC",
"card_type":"bc",
"banks":
	[  
            {  
         "bank_id":"DENZ",
         "is_blocked":"false",
         "instalments":[  
            {  
               "instalment":"0",
               "ratio":"0.1",
               "is_blocked":"false"
            }
         ]
      },
      
   ]
}

```

{% endtab %}

{% tab title="Response" %}

```
{
"object_name":"ratio_define",
"code":0,
"message":"Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

| Sistem           | URL                                             |
| ---------------- | ----------------------------------------------- |
| **Canlı Sistem** | <https://api.paynet.com.tr/v1/ratio/define>     |
| **Test Sistemi** | <https://pts-api.paynet.com.tr/v1/ratio/define> |
| {% endtab %}     |                                                 |
| {% endtabs %}    |                                                 |