👤 Kart Sahibi Kaydı

Endpoint

POST /owner

Açıklama

Kart sahibi (owner) kaydı oluşturur. Bu işlem, tekrarlayan ödemeler ve ödeme emirleri için kart sahibi bilgilerini sisteme kaydeder. Telefon numarası ile kart sahibi tanımlanır.

Headers

Authorization: Bearer {token}
Content-Type: application/json

Request: NewOwnerRequest

{
  "phone": "+905551234567"
}

Parametreler

Parametre	Tip	Zorunlu	Açıklama
phone	string	✅	Kart sahibinin telefon numarası (E.164 formatında)

Response

Başarılı İstek (200 OK)

{
  "success": true
}

Hata Kodları

HTTP Kodu	Açıklama
200	İşlem başarılı
400	Geçersiz istek (telefon numarası formatı hatalı)
401	Yetkisiz erişim (Bearer token geçersiz)
403	Erişim reddedildi

Örnek Kullanım

cURL

curl -X POST https://pgw.klogs.dev/owner \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+905551234567"
  }'

JavaScript

const response = await fetch('https://pgw.klogs.dev/owner', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '+905551234567'
  })
});

const data = await response.json();
console.log(data);

C#

using System.Net.Http;
using System.Text;
using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");

var request = new {
    phone = "+905551234567"
};

var content = new StringContent(
    JsonSerializer.Serialize(request),
    Encoding.UTF8,
    "application/json"
);

var response = await client.PostAsync("https://pgw.klogs.dev/owner", content);
var result = await response.Content.ReadAsStringAsync();

Notlar

• Telefon numarası uluslararası formatta (E.164) olmalıdır (örn: +905551234567)
• Aynı telefon numarası ile birden fazla owner kaydı oluşturulabilir
• Owner ID, sistem tarafından otomatik olarak oluşturulur
• Bu endpoint, kart bilgisi saklamadan önce kullanılmalıdır

İlişkili Endpointler

• Ödeme Emri Oluşturma
• Tekrarlayan Ödeme Oluşturma