Skip to main content
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',
]);

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"
        ]
    ]
}
Ö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
    ]
]);

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"
        ]
    ]
}

Ö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'],
]);

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

​
name
string
required
Müşterinin adı. Bu alan zorunludur ve müşteri oluşturma işlemi için gereklidir.
​
lastname
string
required
Müşterinin soyadı. Bu alan zorunludur ve müşteri oluşturma işlemi için gereklidir.
​
email
string
required
Müşterinin e-posta adresi. Bu alan zorunludur ve müşteri oluşturma işlemi için gereklidir.
​
phone
string
required
Müşterinin telefon numarası. Bu alan zorunludur. Telefon numarası uluslararası formatta olmalıdır.
​
country
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).
​
city
string
Müşterinin bulunduğu şehir. Bu alan isteğe bağlıdır, ancak adres bilgilerini tamamlama için önerilir.
​
district
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.
​
address
string
Müşterinin adresi. Bu alan isteğe bağlıdır, ancak iletişim ve fatura işlemleri için önerilir.
​
zip_code
string
Müşterinin posta kodu. Bu alan isteğe bağlıdır, ancak adres bilgilerini tamamlama için önerilir.
​
metadata
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.