Müşteri Oluşturma

POST /v1/customers
POST /v1/customers/:customer_id
GET /v1/customers/:customer_id
GET /v1/customers/search?:sources
DEL /v1/customers/:customer_id

İstek

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

$customer = $tahsilat->customers->create([
    'name' => 'John',
    'lastname' => 'Doe',
    'email' => '[email protected]',
    'phone' => '1234567890',
]);

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

var request = new CustomerCreateRequest
{
    Name = "John",
    LastName = "Doe",
    Email = "[email protected]",
    Phone = "1234567890",
    Country = "TR",
    City = "İstanbul",
    District = "Kadıköy",
    Address = "123 Main St",
    ZipCode = "34710",
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["special_id"] = "123456",
            ["customer_type"] = "premium"
        },
    }
};

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

curl -L 'https://api.tahsilat.com/v1/customers' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept-Language: tr' \
-H 'Authorization: Bearer {access_token}' \
-d 'name=John' \
-d 'lastname=Doe' \
-d '[email protected]' \
-d 'phone=1234567890' \

Yanıt

^ Tahsilat\Resource\Customer {
    "id": 51503395683326
    "merchant_id": 1234567
    "name": "John"
    "lastname": "Doe"
    "name_lastname": "John Doe"
    "phone_code": "+90"
    "phone": "1234567890"
    "email": "[email protected]"
    "country": "tr"
    "city": null
    "district": null
    "address": null
    "zip_code": null
    "created_via_payment": false
    "created_at": "2025-06-11T20:30:33+03:00"
    "updated_at": "2025-06-11T20:30:33+03:00"
    "formatted_created_at": "11 Haz, 20:30"
    "metadata": []
    "timeline": array:1 [
        0 => array:5 [▼
            "type" => "created"
            "order" => 1
            "text" => "Müşteri oluşturuldu."
            "date" => "11.06.2025 20:30"
            "icon" => "fa-user-clock"
        ]
    ]
}

{
  "Id": 38933812934740,
  "MerchantId": 1234567,
  "Name": "John",
  "LastName": "Doe",
  "NameLastName": "John Doe",
  "PhoneCode": "+90",
  "Phone": "1234567890",
  "Email": "[email protected]",
  "Country": "TR",
  "CountryFlagUrl": "https://files.tahsilat.com/assets/images/flags/tr.svg",
  "City": "İstanbul",
  "District": "Kadıköy",
  "Address": "123 Main St",
  "ZipCode": "34710",
  "CreatedViaPayment": false,
  "CreatedAt": "2025-06-11T20:27:15+03:00",
  "UpdatedAt": "2025-06-11T20:27:15+03:00",
  "FormattedCreatedAt": "4 Mar, 00:34",
  "Metadata": [
    {
      "Key": "customer_type",
      "Value": "premium"
    },
    {
      "Key": "special_id",
      "Value": "123456"
    }
  ],
  "Timeline": [
    {
      "Type": "created",
      "Order": 1,
      "Text": "Müşteri Oluşturuldu.",
      "Date": "04.03.2026 00:34",
      "Icon": "fa-user-clock"
    }
  ]
}

POST /v1/customers
POST /v1/customers/:customer_id
GET /v1/customers/:customer_id
GET /v1/customers/search?:sources
DEL /v1/customers/:customer_id

İstek

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

$customer = $tahsilat->customers->create([
    'name' => 'John',
    'lastname' => 'Doe',
    'email' => '[email protected]',
    'phone' => '1234567890',
]);

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

var request = new CustomerCreateRequest
{
    Name = "John",
    LastName = "Doe",
    Email = "[email protected]",
    Phone = "1234567890",
    Country = "TR",
    City = "İstanbul",
    District = "Kadıköy",
    Address = "123 Main St",
    ZipCode = "34710",
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["special_id"] = "123456",
            ["customer_type"] = "premium"
        },
    }
};

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

curl -L 'https://api.tahsilat.com/v1/customers' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept-Language: tr' \
-H 'Authorization: Bearer {access_token}' \
-d 'name=John' \
-d 'lastname=Doe' \
-d '[email protected]' \
-d 'phone=1234567890' \

Yanıt

^ Tahsilat\Resource\Customer {
    "id": 51503395683326
    "merchant_id": 1234567
    "name": "John"
    "lastname": "Doe"
    "name_lastname": "John Doe"
    "phone_code": "+90"
    "phone": "1234567890"
    "email": "[email protected]"
    "country": "tr"
    "city": null
    "district": null
    "address": null
    "zip_code": null
    "created_via_payment": false
    "created_at": "2025-06-11T20:30:33+03:00"
    "updated_at": "2025-06-11T20:30:33+03:00"
    "formatted_created_at": "11 Haz, 20:30"
    "metadata": []
    "timeline": array:1 [
        0 => array:5 [▼
            "type" => "created"
            "order" => 1
            "text" => "Müşteri oluşturuldu."
            "date" => "11.06.2025 20:30"
            "icon" => "fa-user-clock"
        ]
    ]
}

{
  "Id": 38933812934740,
  "MerchantId": 1234567,
  "Name": "John",
  "LastName": "Doe",
  "NameLastName": "John Doe",
  "PhoneCode": "+90",
  "Phone": "1234567890",
  "Email": "[email protected]",
  "Country": "TR",
  "CountryFlagUrl": "https://files.tahsilat.com/assets/images/flags/tr.svg",
  "City": "İstanbul",
  "District": "Kadıköy",
  "Address": "123 Main St",
  "ZipCode": "34710",
  "CreatedViaPayment": false,
  "CreatedAt": "2025-06-11T20:27:15+03:00",
  "UpdatedAt": "2025-06-11T20:27:15+03:00",
  "FormattedCreatedAt": "4 Mar, 00:34",
  "Metadata": [
    {
      "Key": "customer_type",
      "Value": "premium"
    },
    {
      "Key": "special_id",
      "Value": "123456"
    }
  ],
  "Timeline": [
    {
      "Type": "created",
      "Order": 1,
      "Text": "Müşteri Oluşturuldu.",
      "Date": "04.03.2026 00:34",
      "Icon": "fa-user-clock"
    }
  ]
}

Ödeme işlemlerinizden önce müşteri oluşturarak ödemeleri takip edebilir ve müşteri bilgilerini saklayabilirsiniz. Müşteri oluşturma işlemi, ödeme işlemlerinizin temelini oluşturur.

White label kullanıyorsanız müşteri bilgisi zorunludur.

İstek:

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

$customer = $tahsilat->customers->create([
    'name' => 'John',
    'lastname' => 'Doe',
    'email' => '[email protected]',
    'phone' => '1234567890',
    'country' => 'TR',
    'city' => 'İstanbul',
    'district' => 'Kadıköy',
    'address' => '123 Main St',
    'zip_code' => '34710',
    'metadata' => [
        'customer_type' => 'premium',
        'special_id' => 123456
    ]
]);

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

var request = new CustomerCreateRequest
{
    Name = "John",
    LastName = "Doe",
    Email = "[email protected]",
    Phone = "1234567890",
    Country = "TR",
    City = "İstanbul",
    District = "Kadıköy",
    Address = "123 Main St",
    ZipCode = "34710",
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["special_id"] = "123456",
            ["customer_type"] = "premium"
        },
    }
};

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

curl -L 'https://api.tahsilat.com/v1/customers' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept-Language: tr' \
-H 'Authorization: Bearer {access_token}' \
-d 'name=John' \
-d 'lastname=Doe' \
-d '[email protected]' \
-d 'phone=1234567890' \
-d 'country=TR' \
-d 'city=İstanbul' \
-d 'district=Kadıköy' \
-d 'address=123 Main St' \
-d 'zip_code=34710' \
-d 'metadata={"customer_type":"premium", "special_id":123456}'

Yanıt:

^ Tahsilat\Resource\Customer {
    "id": 18906378310892
    "merchant_id": 1234567
    "name": "John"
    "lastname": "Doe"
    "name_lastname": "John Doe"
    "phone_code": "+90"
    "phone": "1234567890"
    "email": "[email protected]"
    "country": "TR"
    "country_flag_url": "https://files.tahsilat.com/assets/images/flags/tr.svg"
    "city": "İstanbul"
    "district": "Kadıköy"
    "address": "123 Main St"
    "zip_code": "34710"
    "created_via_payment": false
    "created_at": "2025-06-11T20:27:15+03:00"
    "updated_at": "2025-06-11T20:27:15+03:00"
    "formatted_created_at": "11 Haz, 20:27"
    "metadata": array:2 [
        0 => array:5 [
            "merchant_id" => "1234567"
            "key" => "customer_type"
            "value" => "premium"
            "created_at" => "2025-06-11T20:27:15+03:00"
            "updated_at" => "2025-06-11T20:27:15+03:00"
        ]
        1 => array:5 [
            "merchant_id" => "1234567"
            "key" => "special_id"
            "value" => "123456"
            "created_at" => "2025-06-11T20:27:15+03:00"
            "updated_at" => "2025-06-11T20:27:15+03:00"
        ]
    ]
    "timeline": array:1 [
        0 => array:5 [
            "type" => "created"
            "order" => 1
            "text" => "Müşteri oluşturuldu."
            "date" => "11.06.2025 20:27"
            "icon" => "fa-user-clock"
        ]
    ]
}

{
  "Id": 38933812934740,
  "MerchantId": 1234567,
  "Name": "John",
  "LastName": "Doe",
  "NameLastName": "John Doe",
  "PhoneCode": "+90",
  "Phone": "1234567890",
  "Email": "[email protected]",
  "Country": "TR",
  "CountryFlagUrl": "https://files.tahsilat.com/assets/images/flags/tr.svg",
  "City": "İstanbul",
  "District": "Kadıköy",
  "Address": "123 Main St",
  "ZipCode": "34710",
  "CreatedViaPayment": false,
  "CreatedAt": "2025-06-11T20:27:15+03:00",
  "UpdatedAt": "2025-06-11T20:27:15+03:00",
  "FormattedCreatedAt": "4 Mar, 00:34",
  "Metadata": [
    {
      "Key": "customer_type",
      "Value": "premium"
    },
    {
      "Key": "special_id",
      "Value": "123456"
    }
  ],
  "Timeline": [
    {
      "Type": "created",
      "Order": 1,
      "Text": "Müşteri Oluşturuldu.",
      "Date": "04.03.2026 00:34",
      "Icon": "fa-user-clock"
    }
  ]
}

Ödeme Başlatma

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

$customer = $tahsilat->customers->create([
    'name' => 'John',
    'lastname' => 'Doe',
    'email' => '[email protected]',
    'phone' => '1234567890',
    'country' => 'TR',
    'city' => 'İstanbul',
    'district' => 'Kadıköy',
    'address' => '123 Main St',
    'zip_code' => '34710',
    'metadata' => [
        'customer_type' => 'premium',
        'special_id' => 123456
    ]
]);

$payment = $tahsilat->payments->create([
    'customer_id' => $customer->id,
    'currency' => 'TRY',
    'amount' => 1000,
    'product_ids' => ['66659809656479'],
]);

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

var customerRequest = new CustomerCreateRequest
{
    Name = "John",
    LastName = "Doe",
    Email = "[email protected]",
    Phone = "1234567890",
    Country = "TR",
    City = "İstanbul",
    District = "Kadıköy",
    Address = "123 Main St",
    ZipCode = "34710",
    Metadata = new()
    {
        new Dictionary<string, object>
        {
            ["special_id"] = "123456",
            ["customer_type"] = "premium"
        },
    }
};

var customerResponse = await tahsilat.Customers.CreateAsync(customerRequest);

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

var paymentResponse = await tahsilat.Payments.CreateAsync(paymentRequest);

Zorunlu ve İsteğe Bağlı Parametreler

string

required

Müşterinin adı. Bu alan zorunludur ve müşteri oluşturma işlemi için gereklidir.

string

required

Müşterinin soyadı. Bu alan zorunludur ve müşteri oluşturma işlemi için gereklidir.

string

required

Müşterinin e-posta adresi. Bu alan zorunludur ve müşteri oluşturma işlemi için gereklidir.

string

required

Müşterinin telefon numarası. Bu alan zorunludur. Telefon numarası uluslararası formatta olmalıdır.

string

required

Müşterinin bulunduğu ülke. Bu alan zorunludur ve ISO 3166-1 alpha-2 formatında olmalıdır (örneğin, “TR” Türkiye için).

string

Müşterinin bulunduğu şehir. Bu alan isteğe bağlıdır, ancak adres bilgilerini tamamlama için önerilir.

string

Müşterinin bulunduğu ilçe. Bu alan isteğe bağlıdır, ancak adres bilgilerini tamamlama için önerilir. Şehir, ilçe belirtildiğinde bu alan zorunlu hale gelir.

string

Müşterinin adresi. Bu alan isteğe bağlıdır, ancak iletişim ve fatura işlemleri için önerilir.

string

Müşterinin posta kodu. Bu alan isteğe bağlıdır, ancak adres bilgilerini tamamlama için önerilir.

array

Müşteri ile ilişkili ek veriler. Bu alan isteğe bağlıdır ve anahtar-değer çiftleri şeklinde veri saklamak için kullanılabilir. Örneğin, müşteri türü, özel ID gibi bilgiler burada tutulabilir.

Giriş

Tahsilat JS (SDK)

Entegrasyon (SDK)

Müşteriler

Ürünler

Doğrudan API Entegrasyonu

Zorunlu ve İsteğe Bağlı Parametreler

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

Zorunlu ve İsteğe Bağlı Parametreler