Перейти к содержимому
QR code to Stripe paymentsДокументация QR2Stripe

← Все инструкции

Вебхук после платежа

Телефон может после каждого успешного платежа обращаться по выбранному вами адресу, чтобы ваша собственная система узнала о нём. Это не вебхук 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}
}