Web sitemi veya botumu API ile nasıl bağlarım?
ScarabPay ekibi · Güncellendi: 23 Ekim 2026
Siparişlerin otomatik olarak ödenip teslim edilmesini istiyorsan API'yi kullan. Sunucun bir fatura oluşturur, müşteriyi ödeme sayfasına yönlendirir ve ödeme geldiğinde imzalı bir webhook alır.
1. Anahtarlarını al
Projeni aç ve Geliştiriciler sekmesine git. Gerçek ödemeler için bir canlı anahtar ve testler için bir sandbox anahtarı alırsın.
Anahtarını gizli tutAnahtar yalnızca bir kez gösterilir. Onu yalnızca sunucunda sakla; asla bir mobil uygulamada veya herkese açık bir sayfada tutma. Sızarsa Anahtarı değiştir'e dokun.
2. Webhook'unu ekle
- Web sitende veya bot sunucunda olayları alacak URL'yi gir ve Kaydet'e dokun.
- İmzalama anahtarını (signing secret) kopyala ve sunucunda sakla.
- Test olayı gönder'e dokun ve sunucunun 200 durum koduyla yanıt verdiğini kontrol et.
3. Fatura oluştur
Tutar ve sipariş numaranla fatura oluşturmak için bir istek gönder, ardından müşteriyi dönen ödeme bağlantısına yönlendir. invoice.paid olayını aldığında siparişi teslim et.
Sabit adresler
Botlarda bakiye yükleme için her müşteriye kalıcı bir para yatırma adresi verebilirsin. Her para yatırma işlemi bir deposit.received olayı gönderir.
PHP, Node.js ve Python ile tam istek örnekleri API dokümantasyonunda yer alıyor.