Kimlik Doğrulama (Authentication)

Paylox API'ye erişmek için bir Merchant API Key gereklidir. Bu anahtar, Odoo panelinden her merchant için otomatik oluşturulur.

API Key Nasıl Alınır?

1. Odoo paneline giriş yapın
2. Paylox Checkout → Merchants menüsüne gidin
3. Merchant kaydınızı açın
4. Merchant API Key alanını kopyalayın

API Key Kullanımı

API Key, checkout session oluştururken merchant_api_key alanında gönderilir:

{
  "merchant_api_key": "fbd654ad-6448-4cbc-9780-5cdd3eadb677",
  "amount": 1000,
  ...
}

Güvenlik Uyarısı

• API Key'inizi asla frontend kodunda kullanmayın
• Sadece backend (sunucu tarafı) isteklerinde gönderin
• API Key'iniz ele geçirilirse, Odoo panelinden Regenerate API Key ile yenileyin

Base URL

Ortam	URL
Production	https://api.paylox.io/api/v1
Sandbox	https://sandbox-api.paylox.io/api/v1

Rate Limiting

• Dakikada 100 istek limiti vardır
• Limit aşıldığında 429 Too Many Requests yanıtı döner

Hata Yanıtları

Tüm hata yanıtları şu formatta döner:

{
  "detail": "Invalid merchant API key"
}

HTTP Kodu	Açıklama
401	Geçersiz veya eksik API key
404	Session bulunamadı veya süresi doldu
422	İstek formatı hatalı
429	Rate limit aşıldı
500	Sunucu hatası