Webhook Ayarları ve Olayları
Bu sayfa Geliştirici grubundaki iki webhook ekranını anlatır. Webhook’un kendisi ve imza doğrulama ayrı sayfadadır: Webhooks.
Webhook Ayarları
Bölüm başlığı “Webhook Ayarları”Ekran Geliştirici → Webhook Ayarları menüsündedir. Görüntülemek için “Ödeme işlemleri”, değiştirmek için “Webhook yönetimi” yetkisi gerekir. “Webhook yönetimi” yalnız işletme yöneticisinde bulunur. Çalışana verilemez.
Değiştirme yetkisi olmayan kullanıcı ekranı salt okunur görür. Adres ve secret için yalnız “Yapılandırıldı” ya da “Yok” yazar. Secret’ın değeri hiçbir zaman gösterilmez.
| Alan | Kural |
|---|---|
| Webhook adresi | https:// ile başlamalıdır. İnternetten erişilebilir olmalıdır. Kurum içi adres kabul edilmez. LydiaGate olayları bu adrese POST isteğiyle gönderir. |
| İmza secret’ı | İlk kurulumda adresle birlikte zorunludur. Hesap açılışında LydiaGate tanımladıysa alanı boş bırakabilirsiniz. Kayıtlı bir secret varken alanı boş bırakırsanız secret değişmez. Yeni değer girerseniz değişir. |
Eylemler:
- Kaydet: adresi ve varsa yeni secret’ı kaydeder.
- Test gönder: adresinize örnek bir
webhook.testolayı gönderir. Adres ve secret ikisi de kayıtlıysa açıktır. Gönderim yaklaşık 30 saniye içinde yapılır. Sonucu Webhook Olayları ekranında görürsünüz. - URL’i kaldır: adresi siler ve bildirim gönderimini durdurur. Secret kayıtlı kalır.
Webhook Olayları
Bölüm başlığı “Webhook Olayları”Ekran Geliştirici → Webhook Olayları menüsündedir. Görüntülemek için “Ödeme işlemleri” yetkisi gerekir. Her satır bir teslimattır.
| Sütun | İçerik |
|---|---|
| Olay | Olay tipi. Örnek: “Ödeme başarılı”, “İade onaylandı”, “Test webhook’u”. |
| İşlem | İlgili ödemenin kodu. |
| Zaman | Olayın gerçekleştiği an. |
| Deneme | Yapılan deneme sayısı. |
| Durum | Bekliyor, Gönderiliyor, İletildi, Tekrar denenecek, Kalıcı hata. |
Sayfa başına 50 kayıt gelir. “Önceki” ve “Sonraki” ile gezersiniz. Durum filtresi yalnız o sayfadaki kayıtları süzer.
Teslimat detayı
Bölüm başlığı “Teslimat detayı”Bir satıra tıklayınca teslimat detayı açılır. “Özet” sekmesinde “Teslimat” kartı bulunur: olay tipi, durum, deneme sayısı, olay zamanı, sonraki deneme zamanı ve son hata. “Ham JSON” sekmesi sunucunuza giden gövdeyi gösterir ve kopyalama düğmesi taşır.
Yeniden gönderme
Bölüm başlığı “Yeniden gönderme”Yeniden göndermek için “Webhook yönetimi” yetkisi gerekir.
- “İletildi” ya da “Kalıcı hata” durumundaki teslimatta “Yeniden gönder” düğmesi çıkar. Teslimat aynı teslimat kimliğiyle yeniden kuyruğa alınır. Sunucunuz aynı kimliği ikinci kez görebilir. Tekilleştirme kuralı: Webhooks.
- “Tekrar denenecek” durumunda “Şimdi dene” düğmesi çıkar. Bekleme süresini atlar.
- “Bekliyor” ve “Gönderiliyor” durumunda düğme pasiftir.