# Oran Tablosu(Sunucu Tabanlı)

Paynet oran tablosunu secret key ile çağırabileceğiniz servistir. Server tarafında kullanmak için uygundur.

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

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

| Parametre İsmi               | Tip    | Zorunlu | Açıklama                                                                                                                                                                                       |
| ---------------------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **pos\_type**                | int    | Hayır   | Paynet’in pos oranlarını mı yoksa Firma POS oranlarını mı kullanılacak onu belirler. Default olarak Paynet pos’ları çalışır.                                                                   |
| **amount**                   | string | Hayır   | Kredi kartından çekilecek toplam tutarın 100 ile çarpılmış halidir. Gönderilen tutar'a göre instalment\_amount,total\_net\_amount,total\_amount,commision,commision\_tax değerlerini hesaplar. |
| **addcomission\_to\_amount** | bool   | Hayır   | true/false, Default: false. Hizmet bedeli tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda hizmet bedeli tutarı kredi kartından çekilecek tutara eklenir.             |
| **bin**                      | string | Hayır   | Kredi kartının ilk 6 hanesi gönderilir ise sadece kartın ait olduğu bankanın oranlarını döner.                                                                                                 |
| **agent\_id**                | string | Hayır   | Ana firma, bayilerinin oranını görmek isterse; Paynet bayi kodunu değer olarak vermelidir.                                                                                                     |
| **ratio\_code**              | string | Hayır   | Tanımladığınız oran tablosunu kodunu bu alanda gönderirseniz, o koda tanımlı oran ve taksit tablonuz görünür.                                                                                  |
| **card\_type**               | string | Hayır   | <p>Bireysel kartlara ait oran tablosu için: "cc"</p><p>Ticari kartlara ait oran tablosu için: "bc"</p><p>Debit kartlara ait oran tablosu için: "dc"</p>                                        |
| {% endtab %}                 |        |         |                                                                                                                                                                                                |

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

| Parametre İsmi        | Tip     | Açıklama                                                                                                                                                                                                                                                                                                                |
| --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **tds\_required**     | bool    | <p><strong>"data-tds\_required"</strong> attribute’nun default değeri<br><strong>true</strong>'dur</p><p>POS’unuz 3D’li ve 3D’siz işlemi destekliyor ise;</p><p><strong>True</strong>: Kullanıcının 3D’siz  işlem yapmasını engeller.</p><p><strong>False</strong>: kullanıcının 3D’siz işlem yapmasına izin verir.</p> |
| **object\_name**      | string  | Dönüş yapılan API'nin nesne adı "ratio\_get"                                                                                                                                                                                                                                                                            |
| **code**              | string  | Sistem sonuç kodu. [Bakınız](/genel-bilgiler/hata-kodlari/doenues-kodlari.md)                                                                                                                                                                                                                                           |
| **message**           | string  | Sistem mesajı                                                                                                                                                                                                                                                                                                           |
| **Data\[]**           |         |                                                                                                                                                                                                                                                                                                                         |
| =>bank\_id            | char    | Bankanın Paynet sistemindeki kodu                                                                                                                                                                                                                                                                                       |
| =>bank\_logo          | string  | Banka logo                                                                                                                                                                                                                                                                                                              |
| =>bank\_name          | string  | Banka adı                                                                                                                                                                                                                                                                                                               |
| =>card\_type          | string  | Kart tipi (cc: Kredi Kartı, dc: Debit Kart, bc: Ticari Kart)                                                                                                                                                                                                                                                            |
| =>tds\_required       | bool    | default değeri false dur.False : Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasına izin verir.True: Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasını engeller.                                                               |
| =>ratio\[]            |         |                                                                                                                                                                                                                                                                                                                         |
| ->ratio               | float   | Ödeme sırasında kullanılan oran.                                                                                                                                                                                                                                                                                        |
| ->instalment\_key     | string  | İlgili oranın ID'si. Custom Form Entegrasyonunda hangi taksit işlemi geçtiği bu ID gönderilerek olur.                                                                                                                                                                                                                   |
| ->instalment          | int     | Taksit sayısı. [Bakınız](/genel-bilgiler/taksit-kodlari.md)                                                                                                                                                                                                                                                             |
| -> instalment\_amount | decimal | Kredi kartından çekilecek taksit tutarı                                                                                                                                                                                                                                                                                 |
| ->total\_amount       | decimal | Kredi kartından çekilen toplam tutar                                                                                                                                                                                                                                                                                    |
| ->total\_net\_amount  | decimal | Hizmet bedeli hariç tutar                                                                                                                                                                                                                                                                                               |
| ->commission          | decimal | Hizmet bedeli tutarı                                                                                                                                                                                                                                                                                                    |
| ->commission\_tax     | decimal | Hizmet bedeli vergisi                                                                                                                                                                                                                                                                                                   |
| ->desc                | string  | Taksit açıklaması                                                                                                                                                                                                                                                                                                       |
| ->is\_has\_campaign   | bool    | Kampanya var mı (true ise var; false ise yok)                                                                                                                                                                                                                                                                           |
| ->plus\_installment   | int     | Artı taksit sayısı                                                                                                                                                                                                                                                                                                      |
| ->post\_pone          | int     | Erteleme sayısı                                                                                                                                                                                                                                                                                                         |
| ->campaign\_note      | string  | Kampanya notu                                                                                                                                                                                                                                                                                                           |
| {% endtab %}          |         |                                                                                                                                                                                                                                                                                                                         |

{% tab title="Request" %}

```
{  
   "bin":"435508"
}
```

{% endtab %}

{% tab title="Response" %}

```
{
    "data": [
        {
            "bank_id": "AXSS",
            "bank_logo": "https://pts-statics.paynet.com.tr/img/banklogo/small/AXSS.png",
            "bank_name": "Axess",
            "card_type": "bc",
            "tds_required": false,
            "ratio": [
                {
                    "ratio": 0.26,
                    "instalment_key": "ji_*",
                    "instalment": 0,
                    "instalment_amount": 0.0,
                    "total_net_amount": 0.00,
                    "total_amount": 0.0,
                    "commision": 0.00,
                    "commision_tax": 0.00,
                    "desc": "Tek Çekim",
                    "is_has_campaign": true,
                    "plus_installment": 2,
                    "post_pone": 1,
                    "campaign_note": "1+2"
                },
                {
                    "ratio": 0.0767,
                    "instalment_key": "ji_*",
                    "instalment": 6,
                    "instalment_amount": 0.0,
                    "total_net_amount": 0.00,
                    "total_amount": 0.0,
                    "commision": 0.00,
                    "commision_tax": 0.00,
                    "desc": "6 Taksit",
                    "is_has_campaign": false,
                    "plus_installment": 0,
                    "post_pone": 0,
                    "campaign_note": ""
                },               
            ]
        }
    ],
    "tds_required": false,
    "object_name": "ratio_get",
    "code": 0,
    "message": "Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

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


---

# 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/oran/oran-tablosu-sunucu-tabanli.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.
