Webhooks API

Webhook'lar, ödeme olayları gerçekleştiğinde Paylox'un sizin sunucunuza HTTP POST isteği göndermesidir.

Webhook Akışı

Event Türleri

Event	Açıklama	Tetikleyici
payment.completed	Ödeme başarıyla tamamlandı	Capture başarılı
payment.failed	Ödeme başarısız	Banka reddi, timeout
payment.authorized	Ön provizyon onaylandı	Authorization başarılı
refund.completed	İade tamamlandı	İade onaylandı
refund.failed	İade başarısız	Banka iade reddi
session.expired	Session süresi doldu	1 saat doldu

Payload Formatı

{
  "event": "payment.completed",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "order_id": "ORD-xxx",
    "session_id": "ses_xxx",
    "amount": 15000,
    "currency": "TRY",
    "status": "completed",
    "payment_type": "creditcard",
    "card_last_four": "0055"
  }
}

Retry Politikası

Sunucunuz HTTP 200 dönmezse, Paylox isteği tekrar gönderir:

Deneme	Bekleme
1. retry	1 dakika sonra
2. retry	5 dakika sonra
3. retry	30 dakika sonra
4. retry	2 saat sonra
5. retry	24 saat sonra

5 başarısız denemeden sonra webhook gönderimi durdurulur.

Doğrulama

Webhook'un gerçekten Paylox'tan geldiğini doğrulamak için yanıtta gelen imzayı kontrol edin. Detaylar için İmza Doğrulama sayfasına bakın.

uyarı

Webhook handler'ınız idempotent olmalıdır. Aynı event birden fazla kez gelebilir.