Deutsch

English
Türkçe

Deutsch

English
Türkçe

Appearance

👤 Karteninhaber-Registrierung ​

Endpunkt ​

POST /owner

Beschreibung ​

Erstellt einen Karteninhaber-Datensatz. Dieser Vorgang registriert Karteninhaberinformationen im System für wiederkehrende Zahlungen und Zahlungsaufträge. Der Karteninhaber wird durch seine Telefonnummer identifiziert.

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

Anfrage: NewOwnerRequest ​

json
{
  "phone": "+905551234567"
}

Parameter ​

ParameterTypErforderlichBeschreibung
phonestring✅Telefonnummer des Karteninhabers (E.164-Format)

Antwort ​

Erfolgreiche Anfrage (200 OK) ​

json
{
  "success": true
}

Fehlercodes ​

HTTP-CodeBeschreibung
200Operation erfolgreich
400Ungültige Anfrage (ungültiges Telefonnummernformat)
401Unbefugter Zugriff (ungültiges Bearer-Token)
403Zugriff verweigert

Beispielverwendung ​

cURL ​

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

JavaScript ​

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# ​

csharp
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();

Hinweise ​

  • Telefonnummer muss im internationalen Format (E.164) sein (z.B. +905551234567)
  • Mehrere Inhaber-Datensätze können mit derselben Telefonnummer erstellt werden
  • Die Inhaber-ID wird automatisch vom System generiert
  • Dieser Endpunkt sollte vor der Kartenspeicherung verwendet werden

Verwandte Endpunkte ​