Başlangıç
Kimlik Doğrulama
YucePay API'sine yapılan her istek bir API anahtarı ile doğrulanır. Anahtarınızı X-Api-Key başlığında gönderin.
API Anahtarı Alma
API anahtarları panelden yönetilir. Panel → Geliştirici → API Anahtarları bölümünden yeni bir anahtar oluşturun. Anahtar yalnızca oluşturma anında bir kez tam olarak gösterilir — güvenli bir yerde saklayın.
API anahtarınızı asla istemci tarafı (tarayıcı, mobil uygulama) koduna veya herkese açık depolara koymayın. Anahtar sunucu tarafında saklanmalıdır.
X-Api-Key Başlığı
Anahtarı her isteğe X-Api-Key başlığı olarak ekleyin. Anahtarlar pk_ ön eki ile başlar.
| Başlık | Değer | Zorunlu |
|---|---|---|
| X-Api-Key | pk_live_... veya pk_test_... | zorunlu |
| Content-Type | application/json | POST/PUT |
Test ve Canlı Ortam
Her şirket için ayrı test ve canlı anahtarlar üretilir. Test anahtarları gerçek para hareketi oluşturmaz; entegrasyonunuzu doğrulamak için kullanın.
Kimlik Doğrulama Hataları
| HTTP | errorCode | Anlamı |
|---|---|---|
| 401 | AUTH_ERROR | Anahtar eksik, geçersiz veya süresi dolmuş |
| 403 | UNAUTHORIZED | Anahtarın bu işlem için yetkisi yok (izin kısıtı) |
| 429 | RATE_LIMIT_EXCEEDED | İstek limiti aşıldı — bkz. Rate Limitler |
Anahtar sızması durumunda panelden anahtarı hemen iptal edip yenisini oluşturun. Her anahtarın son kullanım tarihi (ExpiresAt) ve izinleri (permissions) panelden ayarlanabilir.