Kimlik Doğrulama (Authentication)

Paylox API'ye erişmek için bir Merchant API Key gereklidir. Bu anahtar, Paylox ekibi tarafından size özel olarak oluşturulup iletilir.

API Key Nasıl Alınır?

1. Paylox ekibine başvurun ([email protected])
2. Ekibimiz işletmeniz için bir merchant hesabı oluşturur
3. Size benzersiz bir Merchant API Key e-posta ile iletilir
4. Bu anahtarı güvenli bir yerde saklayın

ipucu

API Key'inizin yenilenmesi gerekiyorsa (örneğin, güvenlik ihlali durumunda) [email protected] adresine ulaşın. Ekibimiz mevcut anahtarınızı iptal edip yeni bir anahtar oluşturur.

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, derhal Paylox destek ekibine bildirin

Base URL

Ortam	URL
Production	https://api.jetcheckout.com/api/v1
Sandbox	https://sandbox-api.jetcheckout.com/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ı