Ödeme sonrası webhook
Telefon, her başarılı ödemeden sonra seçtiğiniz bir adresi çağırabilir; böylece kendi sisteminiz ödemeden haberdar olur. Bu Stripe'ın webhook'u değildir: çağrı telefondan gelir.
Her ödemeden sonra çağır |
Açma/kapama düğmesi. |
|---|---|
Adres |
Alıcınızın HTTPS adresi, ilk örnekteki gibi. Ana bilgisayardan sonra {reference} gibi değişkenler kullanılabilir. |
Yöntem |
GET, POST veya PUT. Varsayılan POST'tur. |
Gövde biçimi |
JSON, FORM veya TEXT. Varsayılan JSON'dur. |
Üst bilgiler |
Her satıra bir Name: value, örneğin bir API anahtarı veya jeton için. |
Gövde (şablon) |
Değişkenli gövde. Varsayılan, ikinci örnekteki JSON'dur: ödeme kimliği, referans, tutar, para birimi ve zaman içerir. |
İmza sırrı (isteğe bağlı) |
Ayarlanırsa her çağrı X-QR2Stripe-Timestamp ve X-QR2Stripe-Signature (HMAC-SHA256) taşır. |
Ne zaman çağrılır: her başarılı ödemeden sonra bir kez, her modda, uygulama açıkken telefondan. Ağ yoksa uygulama yeniden dener, çağrıyı kuyruğa alır ve bir sonraki başlatmada veya Şimdi ilet düğmesine dokunduğunuzda iletir. 10 denemeden sonra çağrıdan vazgeçilir.
Uygulamada ayarlama: Satıcı ayarları → Ödeme sonrası webhook → Webhook'u ayarla. Her ödemeden sonra çağır seçeneğini açın, adresi girin, Test çağrısı gönder ve Kaydet düğmelerine dokunun. Test çağrısı uydurma bir ödeme gönderir, böylece alıcının onu kabul edip etmediğini hemen görürsünüz.
Alıcı kendi sunucunuz veya webhook tetikleyicisi olan kodsuz bir araç (n8n, Make, Zapier) olabilir. Hızla 2xx durumuyla yanıtlayın; aynı ödeme iki kez gelebilir, bu yüzden onu payment_id ile tanıyın.
{reference}, {amount}, {amount_decimal}, {currency} ve {payment_id} gibi değişkenler ödeme bilgilerini doldurur (tam liste belirtimdedir). Varsayılan gövde ikinci örnekteki JSON'dur.
Sisteminizin her çağrının imzasını doğrulayabilmesi için bir imza sırrı belirleyin ve adresi yayımlamayın. O olmadan adresi bilen herkes size sahte bir çağrı gönderebilir.
Çağrı Stripe'tan değil telefondan gelir. Inline modunda amount_from_qr true'dur; yani tutarı hiçbir sunucu doğrulamamıştır. Değerli bir malı teslim etmeden önce ödemeyi Stripe Dashboard'da bulun.
https://example.com/hook
{
"event": "payment.succeeded",
"payment_id": "{payment_id}",
"reference": "{reference}",
"description": "{description}",
"amount": {amount},
"currency": "{currency}",
"merchant": "{merchant}",
"site": "{site}",
"paid_at": "{paid_at}",
"amount_from_qr": {amount_from_qr}
}