3DS Ödeme

İstek

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

$payment = $tahsilat->payments->create([
    'currency' => 'TRY',
    'amount' => 1000,
    'metadata' => [
        'order_id' => 123456,
        'customer_type' => "premium"
    ],
]);

const tahsilat = new TahsilatSDK('pk_test_wsg...');
const elements = tahsilat.elements();

const paymentElement = elements.create('payment', {
    amount: 1000,
    metadata: [
        { key: "order_id", value: "123456" },
        { key: "customer_type", value: "premium" }
    ],
});

paymentElement.mount('#payment-element');

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

 var request = new PaymentCreateRequest
  {
      Currency = "TRY",
      Amount = 1000,
      Metadata = new()
      {
          new Dictionary<string, object>
          {
              ["order_id"] = 123456,
              ["customer_type"] = "premium"
          }
      }
  };

  var response = await tahsilat.Payments.CreateAsync(request);

    curl -L 'https://api.tahsilat.com/v1/payment/3ds' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -H 'Accept-Language: tr' \
    -H 'Authorization: Bearer {access_token}' \
    -d 'amount=2000' \
    -d 'currency=TRY' \
    -d 'redirect_url=https://example.com' \ -d 'metadata[0][key]=order_id' \
    -d 'metadata[0][value]=order_521234125' \
    -d 'metadata[1][key]=description' \
    -d 'metadata[1][value]=Test'

Yanıt

^ Tahsilat\Resource\Payment {
    "transaction_id": 20094833802557
    "payment_page_url": "https://payment.tahsilat.com/fd094314-df08-48c7-a690-6bbeffd29d11-1234567890"
    "expires_at": "2025-06-11T12:06:35+03:00"
}

// Iframe olarak ya da direkt yönlendirme ile ödeme sayfasına yönlendirilir.

 {
      "ExpiresAt": "2026-03-03T23:50:38+03:00",
      "PaymentPageUrl": "https://payment.sandbox.tahsilat.com/432d05ad-599c-4096-a91a-9b72c0856e39-1772570138",
      "TransactionId": 42794571540514
  }

    {
        "transaction_id": 20094833802557,
        "payment_page_url": "https://payment.tahsilat.com/fd094314-df08-48c7-a690-6bbeffd29d11-1234567890",
        "expires_at": "2025-06-11T12:06:35+03:00"
    }

Secret key sadece arka uçta kullanılmalı ve asla açıkta olmamalıdır. Public key’i güvenle mobil ve web uygulamalarınızda kullanabilirsiniz.

İstek

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

$payment = $tahsilat->payments->create([
    'currency' => 'TRY',
    'amount' => 1000,
    'metadata' => [
        'order_id' => 123456,
        'customer_type' => "premium"
    ],
]);

const tahsilat = new TahsilatSDK('pk_test_wsg...');
const elements = tahsilat.elements();

const paymentElement = elements.create('payment', {
    amount: 1000,
    metadata: [
        { key: "order_id", value: "123456" },
        { key: "customer_type", value: "premium" }
    ],
});

paymentElement.mount('#payment-element');

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

 var request = new PaymentCreateRequest
  {
      Currency = "TRY",
      Amount = 1000,
      Metadata = new()
      {
          new Dictionary<string, object>
          {
              ["order_id"] = 123456,
              ["customer_type"] = "premium"
          }
      }
  };

  var response = await tahsilat.Payments.CreateAsync(request);

    curl -L 'https://api.tahsilat.com/v1/payment/3ds' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -H 'Accept-Language: tr' \
    -H 'Authorization: Bearer {access_token}' \
    -d 'amount=2000' \
    -d 'currency=TRY' \
    -d 'redirect_url=https://example.com' \ -d 'metadata[0][key]=order_id' \
    -d 'metadata[0][value]=order_521234125' \
    -d 'metadata[1][key]=description' \
    -d 'metadata[1][value]=Test'

Yanıt

^ Tahsilat\Resource\Payment {
    "transaction_id": 20094833802557
    "payment_page_url": "https://payment.tahsilat.com/fd094314-df08-48c7-a690-6bbeffd29d11-1234567890"
    "expires_at": "2025-06-11T12:06:35+03:00"
}

// Iframe olarak ya da direkt yönlendirme ile ödeme sayfasına yönlendirilir.

 {
      "ExpiresAt": "2026-03-03T23:50:38+03:00",
      "PaymentPageUrl": "https://payment.sandbox.tahsilat.com/432d05ad-599c-4096-a91a-9b72c0856e39-1772570138",
      "TransactionId": 42794571540514
  }

    {
        "transaction_id": 20094833802557,
        "payment_page_url": "https://payment.tahsilat.com/fd094314-df08-48c7-a690-6bbeffd29d11-1234567890",
        "expires_at": "2025-06-11T12:06:35+03:00"
    }

Secret key sadece arka uçta kullanılmalı ve asla açıkta olmamalıdır. Public key’i güvenle mobil ve web uygulamalarınızda kullanabilirsiniz.

3DS (3D Secure) ödeme, güvenli kart ödemelerini desteklemek için geliştirilmiş bir protokoldür. Tahsilat API’de 3DS ödemeler, tek bir istek ile başlatılır.

Ödeme tutarı ile ürünler arasındaki toplam tutarın eşleşmesi gerekmektedir. Aksi takdirde, ödeme reddedilir.

Ödeme işlemi başlatırken products parametresi yerine product_ids ya da customer_id kullanarak tanımlı ürün ya da müşteri bilgilerini kullanabilirsiniz.

1. Doğrudan Ödeme

Ürün ya da müşteri bilgisi belirtmeden doğrudan ödeme isteği tanımlayabilirsiniz:

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

$payment = $tahsilat->payments->create([
    'currency' => 'TRY',
    'amount' => 1000,
    'metadata' => [
        'order_id' => 123456,
        'customer_type' => "premium"
    ],
]);

const tahsilat = new TahsilatSDK('pk_test_wsg...');
const elements = tahsilat.elements();

const paymentElement = elements.create('payment', {
    amount: 1000,
    metadata: [
        { key: "order_id", value: "123456" },
        { key: "customer_type", value: "premium" }
    ],
});

paymentElement.mount('#payment-element');

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

var request = new PaymentCreateRequest
{
    Currency = "TRY",
    Amount = 1000,
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["order_id"] = 123456,
            ["customer_type"] = "premium"
        }
    }
};

var response = await tahsilat.Payments.CreateAsync(request);

curl -L 'https://api.tahsilat.com/v1/payment/3ds' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept-Language: tr' \
-H 'Authorization: Bearer {access_token}' \
-d 'amount=2000' \
-d 'currency=TRY' \
-d 'redirect_url=https://example.com' \
-d 'metadata[0][key]=order_id' \
-d 'metadata[0][value]=order_521234125' \
-d 'metadata[1][key]=description' \
-d 'metadata[1][value]=Test'

2. Doğrudan Ürün Bilgileri ile Ödeme

Ürün bilgilerini doğrudan ödeme isteği içerisinde tanımlayabilirsiniz:

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

$payment = $tahsilat->payments->create([
    'currency' => 'TRY',
    'amount' => 1000,
    'products' => [
		[
			'product_name' => 'Test Product',
			'price' => 1000,
			'description' => 'This is a test product',
		],
	],
    'metadata' => [
        'order_id' => 123456,
        'customer_type' => "premium"
    ],
]);

const tahsilat = new TahsilatSDK('pk_test_wsg...');
const elements = tahsilat.elements();

const paymentElement = elements.create('payment', {
    amount: 1000,
    products: [
        {
            product_name: 'Test Product',
            price: 1000,
            description: "This is a test product"
        }
    ],
    metadata: [
        { key: "order_id", value: "123456" },
        { key: "customer_type", value: "premium" }
    ],
});

paymentElement.mount('#payment-element');

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

var request = new PaymentCreateRequest
{
    Currency = "TRY",
    Amount = 1000,
    Products = new List<ProductItem>
    {
        new ProductItem
        {
            ProductName = "Test Product",
            Price = 1000,
            Description = "This is a test product"
        },
    },
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["order_id"] = 123456,
            ["customer_type"] = "premium"
        },
    },
};

var response = await tahsilat.Payments.CreateAsync(request);

curl -L 'https://api.tahsilat.com/v1/payment/3ds' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept-Language: tr' \
-H 'Authorization: Bearer {access_token}' \
-d 'amount=2000' \
-d 'currency=TRY' \
-d 'redirect_url=https://example.com' \
-d 'products=[{"product_name": "test", "price": 1000, "description": "Test Açıklaması 1" }, { "product_name": "Test Ürünü 2", "price": 1000, "description": "Test Açıklaması 2" }]' \
-d 'metadata[0][key]=order_id' \
-d 'metadata[0][value]=order_521234125' \
-d 'metadata[1][key]=description' \
-d 'metadata[1][value]=Test'

3. Ürün ID’leri ile Ödeme

Önceden oluşturulmuş ürünlerin ID’lerini kullanarak ödeme başlatabilirsiniz bu durumda ürünleriniz hakkında raporlama ve analiz yapabilirsiniz: Ürünlerin toplam tutarı, ödeme tutarı ile eşleşmelidir. Eğer ürünlerinizin toplam tutarı ödeme tutarından düşükse, ödeme reddedilir. Ürün oluşturmak için Ürünler sayfasını ziyaret edebilirsiniz.

$payment = $tahsilat->payments->create([
    'currency' => 'TRY',
    'amount' => 1000,
    'product_ids' => ['11111111111111', '2222222222222'],
    'metadata' => [
        'order_id' => 123456,
        'customer_type' => "premium"
    ],
]);

const tahsilat = new TahsilatSDK('pk_test_wsg...');
const elements = tahsilat.elements();

const paymentElement = elements.create('payment', {
    amount: 1000,
    product_ids: ['11111111111111', '2222222222222'],
    metadata: [
        { key: "order_id", value: "123456" },
        { key: "customer_type", value: "premium" }
    ],
});

paymentElement.mount('#payment-element');

curl -L 'https://api.tahsilat.com/v1/payment/3ds' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept-Language: tr' \
-H 'Authorization: Bearer {access_token}' \
-d 'amount=2000' \
-d 'currency=TRY' \
-d 'redirect_url=https://example.com' \
-d 'product_ids[0]=55437751141488' \
-d 'product_ids[1]=84920468860151' \
-d 'metadata[0][key]=order_id' \
-d 'metadata[0][value]=order_521234125' \
-d 'metadata[1][key]=description' \
-d 'metadata[1][value]=Test'

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

var request = new PaymentCreateRequest
{
    Amount = 1000,
    Currency = "TRY",
    ProductIds = new List<long>
    {
        11111111111111,
        22222222222222
    },
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["order_id"] = 123456,
            ["customer_type"] = "premium"
        },
    },
};

var response = await tahsilat.Payments.CreateAsync(request);

4. Müşteri ile İlişkilendirilmiş Ödeme

Mevcut bir müşteriyi ödeme ile ilişkilendirmek için customer_id parametresini kullanabilirsiniz. Bu durumda ödeme esnasında müşteri bilgileri tekrardan alınmaz: Müşteri oluşturmak için Müşteriler sayfasını ziyaret edebilirsiniz.

$payment = $tahsilat->payments->create([
    'currency' => 'TRY',
    'amount' => 1000,
    'customer_id' => '99999999999999',
    'product_ids' => ['12345678901234', '23456789012345'],
]);

const tahsilat = new TahsilatSDK('pk_test_wsg...');
const elements = tahsilat.elements();

const paymentElement = elements.create('payment', {
    amount: 1000,
    customer_id: '99999999999999',
    product_ids: ['11111111111111', '2222222222222'],
    metadata: [
        { key: "order_id", value: "123456" },
        { key: "customer_type", value: "premium" }
    ],
});

paymentElement.mount('#payment-element');

curl -L 'https://api.tahsilat.com/v1/payment/3ds' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept-Language: tr' \
-H 'Authorization: Bearer {access_token}' \
-d 'customer_id=20585467989184' \
-d 'amount=2000' \
-d 'currency=TRY' \
-d 'redirect_url=https://example.com' \
-d 'product_ids[0]=55437751141488' \
-d 'product_ids[1]=84920468860151' \
-d 'metadata[0][key]=order_id' \
-d 'metadata[0][value]=order_521234125' \
-d 'metadata[1][key]=description' \
-d 'metadata[1][value]=Test'

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

var request = new PaymentCreateRequest
{
    Amount = 1000,
    Currency = "TRY",
    CustomerId = 99999999999999,
    ProductIds = new List<long>
    {
        11111111111111,
        22222222222222
    },
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["order_id"] = 123456,
            ["customer_type"] = "premium"
        },
    },
};

var response = await tahsilat.Payments.CreateAsync(request);

Ödeme isteği oluşturulurken customer_id gönderilmemesi durumunda her ödeme için müşteri bilgileri tekrar alınır ve yeni bir müşteri oluşturulur. Bu durumda müşteri takibi ve raporlama süreci zorlaşabilir.Üye işyeri arayüzünden ya da Müşteriler sayfasından api aracılığı ile müşteri oluşturarak customer_id parametresini kullanabilirsiniz.

Zorunlu ve İsteğe Bağlı Parametreler

integer

Ödeme ile ilişkilendirilecek müşteri ID’si. Bu parametre isteğe bağlıdır, ancak müşteri takibi için önerilir.

integer

required

Ödeme tutarı, kuruş cinsinden belirtilmelidir. Örneğin, 10.00 TL için 1000 olarak girilmelidir. Son 2 hane her zaman kuruş olarak kabul edilir.

string

required

Ödeme para birimi. 3 haneli ISO 4217 kodu olarak belirtilmelidir (örn. “TRY” - Türk Lirası).

string

Ödeme sonrası yönlendirilecek URL. Bu parametre boş bırakılır ya da gönderilmezse, varsayılan olarak Tahsilat ödeme sonuç sayfasına yönlendirilir.Query paremetresi olarak sadece “transaction_id” içermelidir. Örneğin: https://www.example.com/odeme-sonucu?transaction_id=1234567890

bool

Ödeme ön provizyon olarak başlatılacaksa true, normal ödeme için false olarak belirtilmelidir. Varsayılan değer false’dir.

array

required

Ödeme ile ilişkilendirilecek ürünlerin bilgilerini içeren dizi. Eğer product_ids gönderilmiyorsa, bu parametre zorunludur. Her ürün için aşağıdaki alanlar belirtilmelidir:

product_name: Ürün adı (string)
price: Ürün fiyatı (integer) (kuruş cinsinden)
description: Ürün açıklaması (string) (isteğe bağlı)

array

required

Ödeme ile ilişkilendirilecek ürünlerin ID’lerini içeren dizi. Eğer products gönderilmiyorsa, bu parametre zorunludur. Her ürün için Tahsilat API’de önceden oluşturulmuş ürün ID’leri kullanılmalıdır.

array

Ödeme ile ilişkilendirilecek ek verileri içeren dizi. Bu parametre isteğe bağlıdır, ancak ödeme raporlaması için önerilir. Örneğin, müşteri türü gibi bilgiler burada saklanabilir.

string

Ödeme ile ilgili açıklama. Bu parametre isteğe bağlıdır ve ödeme hakkında ek bilgi sağlamak için kullanılabilir.

Giriş

Tahsilat JS (SDK)

Entegrasyon (SDK)

Müşteriler

Ürünler

Doğrudan API Entegrasyonu

1. Doğrudan Ödeme

2. Doğrudan Ürün Bilgileri ile Ödeme

3. Ürün ID’leri ile Ödeme

4. Müşteri ile İlişkilendirilmiş Ödeme

Zorunlu ve İsteğe Bağlı Parametreler

​1. Doğrudan Ödeme

​2. Doğrudan Ürün Bilgileri ile Ödeme

​3. Ürün ID’leri ile Ödeme

​4. Müşteri ile İlişkilendirilmiş Ödeme

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

1. Doğrudan Ödeme

2. Doğrudan Ürün Bilgileri ile Ödeme

3. Ürün ID’leri ile Ödeme

4. Müşteri ile İlişkilendirilmiş Ödeme

Zorunlu ve İsteğe Bağlı Parametreler