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