👤 Card Owner Registration

Endpoint

POST /owner

Description

Creates a card owner record. This operation registers card owner information in the system for recurring payments and payment orders. The card owner is identified by their phone number.

Headers

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

Request: NewOwnerRequest

{
  "phone": "+905551234567"
}

Parameters

Parameter	Type	Required	Description
phone	string	✅	Card owner's phone number (E.164 format)

Response

Successful Request (200 OK)

{
  "success": true
}

Error Codes

HTTP Code	Description
200	Operation successful
400	Invalid request (invalid phone number format)
401	Unauthorized access (invalid Bearer token)
403	Access denied

Example Usage

cURL

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

JavaScript

const response = await fetch('https://pgw.klogs.io/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.io/owner", content);
var result = await response.Content.ReadAsStringAsync();

Notes

• Phone number must be in international format (E.164) (e.g., +905551234567)
• Multiple owner records can be created with the same phone number
• Owner ID is automatically generated by the system
• This endpoint should be used before card information storage

Related Endpoints

• Create Payment Order
• Create Recurring Payment