> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tahsilat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Komisyon ve Taksitler

> Modern ödeme altyapısı için güçlü ve esnek API çözümü

Pos'larınız üzerinden yapılan ödemelerin komisyon ve taksitlerini yönetmek için Tahsilat API'yi kullanabilirsiniz. Bu API, ödemelerinizin komisyon oranlarını ve taksit bilgilerini sorgulamanızı sağlar.

***

İstek:

<CodeGroup>
  ```php PHP theme={null}
  $tahsilat = new TahsilatClient('sk_test_rwwg...');

  $transaction = $tahsilat->commissions->search();
  ```

  ```csharp .NET theme={null}
  var tahsilat = new TahsilatClient("sk_test_rwwg...");

  var commissions = await tahsilat.Commissions.SearchAsync();
  ```

  ```curl cURL theme={null}
  curl -L 'https://api.tahsilat.com/v1/pos/commissions?bin_number=52001700' \
  -H 'Accept-Language: tr' \
  -H 'Authorization: Bearer {access_token}'
  ```
</CodeGroup>

Yanıt:

<CodeGroup>
  ```php PHP theme={null}
  ^ Tahsilat\Resource\Commission {
      "0" => array:16 [
          "merchant_id" => 1234567,
          "company_pos_credential_id" => 4,
          "pos_id" => 4,
          "pos_name" => "Ziraat Pay Pos",
          "installment" => 1,
          "installment_text" => "Tek çekim",
          "card_type" => "credit",
          "is_on_us" => false,
          "is_foreign" => false,
          "commission_rate" => 3.0,
          "commission_by" => 1,
          "commission_by_text" => "Üye İşyeri",
          "created_at" => "2025-06-03T21:27:18+03:00",
          "updated_at" => "2025-06-03T21:27:18+03:00",
          "card_family" => [
          "name" => "Axess",
          "slug" => "axess",
          "logo_url" => "https://files.tahsilat.com/assets/images/card-families/axess.webp",
          "created_at" => "2026-01-03T23:35:45+03:00",
          "updated_at" => "2026-01-03T23:35:45+03:00",
          ],
          "card_segment_type" => [
          "name" => "Consumer",
          "slug" => "consumer",
          "created_at" => "2026-01-03T23:35:45+03:00",
          "updated_at" => "2026-01-03T23:35:45+03:00",
          ],
      ],
      "1" => array:16
      "2" => array:16
      "3" => array:16
      "4" => array:16
      "5" => array:16
  }
  ```

  ```csharp .NET theme={null}
  [
    {
      "MerchantId": 1234567,
      "CompanyPosCredentialId": 4,
      "PosId": 4,
      "PosName": "Ziraat Pay Pos",
      "Installment": 1,
      "InstallmentText": "Tek çekim",
      "CardType": "credit",
      "IsOnUs": false,
      "IsForeign": false,
      "CommissionRate": 3.0,
      "CommissionBy": 1,
      "CommissionByText": "Üye İşyeri",
      "CreatedAt": "2025-06-03T21:27:18+03:00",
      "UpdatedAt": "2025-06-03T21:27:18+03:00",
      "CardFamily": {
        "Name": "Axess",
        "Slug": "axess",
        "LogoUrl": "https://files.tahsilat.com/assets/images/card-families/axess.webp",
        "CreatedAt": "2025-06-03T21:27:18+03:00",
        "UpdatedAt": "2025-06-03T21:27:18+03:00"
      },
      "CardSegmentType": {
        "Name": "Consumer",
        "Slug": "consumer",
        "CreatedAt": "2025-06-03T21:27:18+03:00",
        "UpdatedAt": "2025-06-03T21:27:18+03:00"
      }
    },
    {
      "MerchantId": 1234567,
      "CompanyPosCredentialId": 4,
      "PosId": 4,
      "PosName": "Ziraat Pay Pos",
      "Installment": 3,
      "InstallmentText": "3 Taksit",
      "CardType": "credit",
      "IsOnUs": true,
      "IsForeign": false,
      "CommissionRate": 4.45,
      "CommissionBy": 1,
      "CommissionByText": "Üye İşyeri",
      "CreatedAt": "2025-06-03T21:27:18+03:00",
      "UpdatedAt": "2025-06-03T21:27:18+03:00",
      "CardFamily": {
        "Name": "Bonus",
        "Slug": "bonus",
        "LogoUrl": "https://files.tahsilat.com/assets/images/card-families/bonus.webp",
        "CreatedAt": "2025-06-03T21:27:18+03:00",
        "UpdatedAt": "2025-06-03T21:27:18+03:00"
      },
      "CardSegmentType": {
        "Name": "Consumer",
        "Slug": "consumer",
        "CreatedAt": "2025-06-03T21:27:18+03:00",
        "UpdatedAt": "2025-06-03T21:27:18+03:00"
      }
    },
  ]
  ```
</CodeGroup>

## Yanıt Satırındaki POS ve Kart Boyutu Alanları

Üye işyerinin birden fazla POS'u olabilir; liste **tüm aktif POS'ların** oranlarını döner
ve aynı oran birden fazla kez görünebilir. Her satır **hangi POS'a** ve **hangi kart
senaryosuna** ait olduğunu taşıdığı için ayırt edilebilir. Bir satırı benzersiz kılan alanlar:

<ResponseField name="pos_name" type="string | null">
  Oranın ait olduğu POS'un adı (ör. `Ziraat Pay Pos`).
</ResponseField>

<ResponseField name="pos_id" type="integer | null">
  Oranın ait olduğu POS entegrasyonunun kimliği.
</ResponseField>

<ResponseField name="company_pos_credential_id" type="integer | null">
  Oranın ait olduğu POS kredensiyalinin kimliği.
</ResponseField>

<ResponseField name="installment" type="integer">
  Taksit sayısı (`1` = tek çekim).
</ResponseField>

<ResponseField name="card_type" type="string | null">
  Oranın geçerli olduğu kart türü: `credit`, `debit`, `prepaid`. `null` ise tüm kart türlerine uygulanır.
</ResponseField>

<ResponseField name="is_on_us" type="boolean | null">
  `true` = kartı çıkaran bankanın kendi POS'una (on-us) ait oran, `false` = on-us olmayan,
  `null` = her ikisi için de geçerli.
</ResponseField>

<ResponseField name="is_foreign" type="boolean">
  `true` ise oran yabancı (yurt dışı) kartlar için geçerlidir; `false` yerli kartlar içindir.
</ResponseField>

## Zorunlu ve İsteğe Bağlı Parametreler

<ResponseField name="bin_number" type="integer">
  Kartın 8 haneli BIN numarası. İsteğe bağlıdır, ancak **göndermeniz önerilir**.

  BIN gönderildiğinde yanıt, o kart için gerçekten uygulanacak komisyonları döner:
  sistem kartı çözer, üye işyerinin tüm POS'ları arasından her taksit seçeneği için
  kazanan POS'u belirler ve o POS'un oranlarını listeler. Böylece burada gördüğünüz
  oran, ödeme alındığında uygulanacak oranla aynı olur.

  BIN gönderilmezse kart bilinmediği için yönlendirme yapılamaz; üye işyerinin
  **tüm aktif POS'larının** tanımlı komisyon kayıtları, her satır kendi POS'una
  etiketli olacak şekilde listelenir.
</ResponseField>

<div className="panels">
  <Panel>
    İstek

    <CodeGroup>
      ```php PHP theme={null}
      $tahsilat = new TahsilatClient('sk_test_rwwg...');

      $transaction = $tahsilat->commissions->search();
      ```

      ```csharp .NET theme={null}
      var tahsilat = new TahsilatClient("sk_test_rwwg...");

      var commissions = await tahsilat.Commissions.SearchAsync();
      ```

      ```curl cURL theme={null}
      curl -L 'https://api.tahsilat.com/v1/pos/commissions?bin_number=52001700' \
      -H 'Accept-Language: tr' \
      -H 'Authorization: Bearer {access_token}'
      ```
    </CodeGroup>

    <br />

    Yanıt

    <CodeGroup>
      ```php PHP theme={null}
      ^ Tahsilat\Resource\Commission {
          "0" => array:16 [
              "merchant_id" => 1234567
              "company_pos_credential_id" => 4
              "pos_id" => 4
              "pos_name" => "Ziraat Pay Pos"
              "installment" => 1
              "installment_text" => "Tek çekim"
              "card_type" => "credit"
              "is_on_us" => false
              "is_foreign" => false
              "commission_rate" => 3.0
              "commission_by" => 1
              "commission_by_text" => "Üye İşyeri"
              "created_at" => "2025-06-03T21:27:18+03:00"
              "updated_at" => "2025-06-03T21:27:18+03:00"
              "card_family" => array:5
              "card_segment_type" => array:4
          ]
          "1" => array:16
          "2" => array:16
          "3" => array:16
          "4" => array:16
          "5" => array:16
      }
      ```

      ```csharp .NET theme={null}
      {
        "MerchantId": 1234567,
        "CompanyPosCredentialId": 4,
        "PosId": 4,
        "PosName": "Ziraat Pay Pos",
        "Installment": 1,
        "InstallmentText": "Tek çekim",
        "CardType": "credit",
        "IsOnUs": false,
        "IsForeign": false,
        "CommissionRate": 3.0,
        "CommissionBy": 1,
        "CommissionByText": "Üye İşyeri",
        "CreatedAt": "2025-06-03T21:27:18+03:00",
        "UpdatedAt": "2025-06-03T21:27:18+03:00",
        "CardFamily": {
          "Name": "Axess",
          "Slug": "axess",
          "LogoUrl": "https://files.tahsilat.com/assets/images/card-families/axess.webp",
          "CreatedAt": "2025-06-03T21:27:18+03:00",
          "UpdatedAt": "2025-06-03T21:27:18+03:00"
        },
        "CardSegmentType": {
          "Name": "Consumer",
          "Slug": "consumer",
          "CreatedAt": "2025-06-03T21:27:18+03:00",
          "UpdatedAt": "2025-06-03T21:27:18+03:00"
        }
      },
      {
        "MerchantId": 1234567,
        "CompanyPosCredentialId": 4,
        "PosId": 4,
        "PosName": "Ziraat Pay Pos",
        "Installment": 3,
        "InstallmentText": "3 Taksit",
        "CardType": "credit",
        "IsOnUs": true,
        "IsForeign": false,
        "CommissionRate": 4.45,
        "CommissionBy": 1,
        "CommissionByText": "Üye İşyeri",
        "CreatedAt": "2025-06-03T21:27:18+03:00",
        "UpdatedAt": "2025-06-03T21:27:18+03:00",
        "CardFamily": {
          "Name": "Bonus",
          "Slug": "bonus",
          "LogoUrl": "https://files.tahsilat.com/assets/images/card-families/bonus.webp",
          "CreatedAt": "2025-06-03T21:27:18+03:00",
          "UpdatedAt": "2025-06-03T21:27:18+03:00"
        },
        "CardSegmentType": {
          "Name": "Consumer",
          "Slug": "consumer",
          "CreatedAt": "2025-06-03T21:27:18+03:00",
          "UpdatedAt": "2025-06-03T21:27:18+03:00"
        }
      },
      ```
    </CodeGroup>

    <Note>
      Bu uç nokta yalnızca secret key ile alınan access token üzerinden çağrılır.
      Secret key sadece arka uçta kullanılmalı ve asla istemci tarafında açıkta olmamalıdır.
    </Note>
  </Panel>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.