Komisyon ve Taksitler

İstek

$tahsilat = new TahsilatClient('sk_test_rwwg...');

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

var tahsilat = new TahsilatClient("sk_test_rwwg...");

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

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

Yanıt

^ 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
}

{
  "MerchantId": 1234567,
  "CompanyPosCredentialId": 4,
  "PosId": 4,
  "PosName": "Ziraat Pay Pos",
  "Installment": 1,
  "InstallmentText": "Tek çekim",
  "CardType": "credit",
  "IsOnUs": false,
  "IsForeign": false,
  "CommissionRate": 2.99,
  "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"
  }
},

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.

İstek

$tahsilat = new TahsilatClient('sk_test_rwwg...');

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

var tahsilat = new TahsilatClient("sk_test_rwwg...");

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

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

Yanıt

^ 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
}

{
  "MerchantId": 1234567,
  "CompanyPosCredentialId": 4,
  "PosId": 4,
  "PosName": "Ziraat Pay Pos",
  "Installment": 1,
  "InstallmentText": "Tek çekim",
  "CardType": "credit",
  "IsOnUs": false,
  "IsForeign": false,
  "CommissionRate": 2.99,
  "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"
  }
},

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.

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:

$tahsilat = new TahsilatClient('sk_test_rwwg...');

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

var tahsilat = new TahsilatClient("sk_test_rwwg...");

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

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

Yanıt:

^ 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
}

[
  {
    "MerchantId": 1234567,
    "CompanyPosCredentialId": 4,
    "PosId": 4,
    "PosName": "Ziraat Pay Pos",
    "Installment": 1,
    "InstallmentText": "Tek çekim",
    "CardType": "credit",
    "IsOnUs": false,
    "IsForeign": false,
    "CommissionRate": 2.99,
    "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"
    }
  },
]

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:

string | null

Oranın ait olduğu POS’un adı (ör. Ziraat Pay Pos).

integer | null

Oranın ait olduğu POS entegrasyonunun kimliği.

integer | null

Oranın ait olduğu POS kredensiyalinin kimliği.

integer

Taksit sayısı (1 = tek çekim).

string | null

Oranın geçerli olduğu kart türü: credit, debit, prepaid. null ise tüm kart türlerine uygulanır.

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.

boolean

true ise oran yabancı (yurt dışı) kartlar için geçerlidir; false yerli kartlar içindir.

Zorunlu ve İsteğe Bağlı Parametreler

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.

Giriş

Tahsilat JS (SDK)

Entegrasyon (SDK)

Müşteriler

Ürünler

Doğrudan API Entegrasyonu

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

Zorunlu ve İsteğe Bağlı Parametreler

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

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

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

Zorunlu ve İsteğe Bağlı Parametreler