API isteklerim neden hata veriyor?
Son güncelleme: 23 Ekim 2026
API hata verdiğinde yanıtta error.code ve açıklama döner. En sık karşılaşılanlar:
| Kod | Anlamı | Ne yapmalı? |
|---|---|---|
unauthorized (401) |
Gizli anahtar eksik veya hatalı | Authorization: Bearer sk_live_… başlığını kontrol edin; anahtarı yenilediyseniz sunucunuzu güncelleyin. |
forbidden (403) |
Erişim askıda veya mağaza aktif değil | API sanal POS sayfasındaki uyarıyı okuyun, destek ekibine yazın. |
validation_error (422) |
Gönderilen alanlardan biri hatalı | fields içinde hangi alanın neden reddedildiği yazar. |
duplicate_order_id (409) |
Bu sipariş numarasıyla zaten ödeme var | Mevcut ödemeyi kullanın ya da iptal edip yeni sipariş numarasıyla oluşturun. |
invalid_state (409) |
İşlem bu durumda yapılamaz | Ör. ödenmiş bir ödeme iptal edilemez; iade kullanın. |
service_unavailable (503) |
Hizmet geçici olarak kapalı | Bir süre sonra tekrar deneyin. |
"Adres https olmalı ve başvurudaki web sitenizin alan adında bulunmalı" hatası: success_url, fail_url ve callback_url yalnızca başvuruda bildirdiğiniz alan adında (ve alt alan adlarında) olabilir. Farklı bir alan adı kullanacaksanız destek ekibine yazın.
Tutar hatası: Tutarı nokta ile ve en fazla iki ondalıkla gönderin (1249.90). Virgül kullanmayın.