API'ye Genel Bakış

Taban adres

https://api-gateway.lunixi.com/api/v1

Sürüm URL yolunda taşınır. Bölgesel ayrı bir adres yoktur — tek taban adres kullanılır.

URL aileleri

Platformda beş ayrı kök vardır ve bunlar farklı tüketiciler içindir:

Kök	Kimin için
`/api/v1`	Müşteri / entegratör — bu dokümantasyonun anlattığı yüzey
`/api/panel/v1`	Yönetim paneli
`/api/portal/v1`	Müşteri portalı
`/api/public/v1`	Kimlik doğrulama gerektirmeyen genel uçlar
`/api/partner/v1`	Partner akışları

⚠️

Bu dokümantasyon yalnız /api/v1 yüzeyini anlatır. Bir uç burada belgelenmemişse entegrasyona açık değildir — panel yollarını çağırmayın; sözleşme garantisi yoktur ve haber vermeden değişebilir.

İstek biçimi

Content-Type: application/json
Zaman damgaları ISO 8601
Tutarlar minör-birim tam sayı — 250000 = ₺2.500,00, asla ondalık değil
Dil: x-lang başlığı (ya da Accept-Language); verilmezse tr

Kimlik doğrulama

Ed25519 anahtarınızla kısa ömürlü bir token basar, onu Authorization: Bearer ile gönderirsiniz. Para hareketi uçları ayrıca isteğin üzerine imza ister (Step-Up).

→ Kimlik Doğrulama

Idempotency

Ödeme intent'i oluşturma çağrısı Idempotency-Key başlığını kabul eder:

Idempotency-Key: 7f3d9c1a-4b2e-4f8a-9c6d-1e5f7a3b8d2c

X-Idempotency-Key de kabul edilir
En fazla 200 karakter
Aynı anahtarla tekrarlanan çağrı yeni bir intent açmaz

Idempotency her POST için genel bir mekanizma değildir. Capture, refund ve void'in kendi dayanıklı tekrar-koruması vardır; onlarda bu başlığa ihtiyaç duymazsınız. Ayrıntı: Ödemelerde Kimlik Doğrulama

Yanıt zarfı

Başarılı yanıtlar veriyi taşır. Hata yanıtları şu şekildedir:

{
  "status": "failure",
  "code": "payment.card.declined",
  "message": "Kart reddedildi.",
  "details": { },
  "timestamp": 1755424304118
}

⚠️

message'a göre değil code'a göre dallanın. message çevrilebilir ve değişebilir; code sözleşmenin parçasıdır ve sabittir.

Ürün uç aileleri

Ürün	Kök
Ödemeler	`/api/v1/payments`
Cüzdan	`/api/v1/wallet`
Fraud	`/api/v1/fraud`
Yaptırım	`/api/v1/sanction`
Identity	`/api/v1/identity`
Organizasyon & webhook yönetimi	`/api/v1/organizations`

Her ürünün kendi bölümünde alan bazlı sözleşmesi vardır.

Sonraki adımlar

Kimlik Doğrulama — token basma ve Step-Up
Hızlı Başlangıç — ilk çağrı
Webhook'lar — olayları almak

SDK'lar Sayfalama