Вебхук после платежа
Телефон может после каждого успешного платежа обращаться по выбранному вами адресу, чтобы ваша собственная система узнала о нём. Это не вебхук Stripe: вызов приходит с телефона.
Вызывать после каждого платежа |
Переключатель. |
|---|---|
Адрес |
Адрес HTTPS вашего получателя, как в первом примере. После хоста можно использовать переменные, например {reference}. |
Метод |
GET, POST или PUT. По умолчанию POST. |
Формат тела |
JSON, FORM или TEXT. По умолчанию JSON. |
Заголовки |
Один Name: value в строке, например для ключа API или токена. |
Тело (шаблон) |
Тело с переменными. По умолчанию это JSON из второго примера с ID платежа, референсом, суммой, валютой и временем. |
Секрет подписи (необязательно) |
Если задан, каждый вызов содержит X-QR2Stripe-Timestamp и X-QR2Stripe-Signature (HMAC-SHA256). |
Когда вызывается: один раз после каждого успешного платежа, в любом режиме, с телефона, пока приложение открыто. Если сети нет, приложение повторяет попытку, ставит вызов в очередь и доставляет его при следующем запуске или когда вы нажмёте Доставить сейчас. После 10 попыток вызов отменяется.
Настройка в приложении: Настройки продавца → Вебхук после платежа → Настроить вебхук. Включите Вызывать после каждого платежа, введите адрес, нажмите Отправить тестовый вызов и Сохранить. Тестовый вызов отправляет вымышленный платёж, поэтому вы сразу видите, принимает ли его получатель.
Получателем может быть ваш собственный сервер или no-code-инструмент (n8n, Make, Zapier) с триггером webhook. Быстро отвечайте статусом 2xx; один и тот же платёж может прийти дважды, поэтому узнавайте его по payment_id.
Переменные вроде {reference}, {amount}, {amount_decimal}, {currency} и {payment_id} подставляют данные платежа (полный список в спецификации). Тело по умолчанию — JSON из второго примера.
Задайте секрет подписи, чтобы ваша система могла проверять подпись каждого вызова, и не публикуйте адрес. Без него любой, кто знает адрес, мог бы прислать вам поддельный вызов.
Вызов приходит с телефона, а не от Stripe. В режиме Inline amount_from_qr равно true, то есть сумму не проверял ни один сервер. Прежде чем передавать ценный товар, найдите платёж в Stripe Dashboard.
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}
}