Referans & Yardım

SSS ve Yardım

Sık sorulan sorular ve entegrasyon ipuçları.

API anahtarımı nereden alırım?

Panel → Geliştirici → API Anahtarları bölümünden oluşturursunuz. Tam anahtar yalnızca bir kez gösterilir.

Test kartı ile nasıl deneme yaparım?

pk_test_ ile başlayan test anahtarını kullanın. Test ortamı gerçek para hareketi oluşturmaz.

idempotencyKey neden zorunlu?

Ağ hatası vb. nedenlerle aynı isteğin tekrar gönderilmesi durumunda çift çekimi önler. Her ödeme için benzersiz bir değer üretin.

Webhook imzasını nasıl doğrularım?

X-Webhook-Signature başlığını, ham gövdenin webhook secret ile HMAC-SHA256 (hex) imzasıyla karşılaştırın. Ayrıntı için Webhook sayfasına bakın.

Kısmi iade yapabilir miyim?

Evet. /api/Refund/partial ile toplam tutarı aşmayacak şekilde birden fazla kısmi iade yapabilirsiniz.

Rate limit'e takıldım, ne yapmalıyım?

429 yanıtındaki Retry-After başlığı kadar bekleyip yeniden deneyin; üstel geri çekilme uygulayın.