Когда клиент оплачивает заказ, об этом нужно сообщить вашей системе: отметить заказ как оплаченный, собрать товар, выставить счёт и отправить подтверждение. Проверять выписку вручную можно на старте, но с ростом продаж это тормозит всю работу. Именно для этого и нужны платёжные вебхуки.
Что такое платёжный вебхук
Это автоматическое уведомление, которое платёжная платформа отправляет на адрес (URL) вашей системы, когда с платежом что-то происходит: оплачен Pix, погашен boleto, одобрена или возвращена покупка по карте. Вместо того чтобы регулярно спрашивать, оплатил ли клиент, ваша система получает сообщение сразу после смены статуса.
Как это работает: шаг за шагом
- Вы указываете URL: адрес вашей системы для приёма уведомлений — в личном кабинете или в поле postbackUrl платежа, созданного через API.
- Клиент платит: через Pix, кредитной картой или boleto.
- Платформа отправляет уведомление: HTTP-запрос POST с данными события в формате JSON.
- Ваша система подтверждает заказ: проверяет уведомление, обновляет статус и отвечает кодом HTTP 200, подтверждая получение.
Что содержит вебхук
В каждом уведомлении есть уникальный идентификатор события, статус платежа и данные транзакции. Упрощённый пример: {"id": "evt_...", "status": "LIQUIDATED", "data": {"value": "16.5", "txId": "...", "method": "pix"}}.
В Sila Pay в личном кабинете можно выбрать, какие события получать: например, покупка одобрена (purchase_approved), Pix оплачен (pix_paid), boleto оплачен (boleto_paid), срок Pix истёк, покупка возвращена.
Где вебхуки помогают в повседневной работе
- Автоматическая обработка заказов: заказ получает статус «оплачен» в вашей системе или ERP без проверки выписок.
- Склад и доставка: сборка начинается сразу после подтверждения оплаты.
- Цифровые товары и услуги: открывайте доступ, выдавайте билеты или подтверждайте запись сразу после оплаты.
- Просроченные платежи: узнавайте, когда Pix или boleto истёк без оплаты, и возвращайтесь к клиенту.
Хотите автоматизировать подтверждение заказов? Откройте аккаунт в Sila Pay
Рекомендации по приёму вебхуков
- Проверяйте подпись: каждое уведомление Sila Pay содержит заголовок X-Silapay-Signature — HMAC-SHA256, вычисленный с вашим секретом. Проверяйте его перед обработкой.
- Отвечайте быстро: возвращайте HTTP 200 в течение 5 секунд, а долгие задачи, например выставление счёта, выполняйте позже.
- Учитывайте повторы: если ваша система не ответила, платформа повторит отправку; используйте id события, чтобы не обработать одно уведомление дважды.
- Используйте HTTPS и берегите секрет: храните его на сервере, а не на сайте или в приложении.
Частые вопросы
Нужно ли быть программистом, чтобы использовать вебхуки?
Кто-то должен настроить адрес для приёма уведомлений. Многие ERP и платформы для интернет-магазинов уже поддерживают эту функцию; если вы используете WooCommerce или Shopify, у Sila Pay есть плагины для подключения магазина.
Чем вебхук отличается от API?
Через API ваша система обращается к платформе — например, чтобы создать платёж. Через вебхук уже платформа обращается к вашей системе, чтобы сообщить об изменении. Обычно они работают вместе.
Что, если моя система недоступна?
Sila Pay автоматически повторяет отправку, если не получает ответ HTTP 200. Тем не менее для длительных сбоев стоит предусмотреть регулярную сверку.
Где найти документацию?
На doc.silapay.pro: там есть список событий, формат payload и пример проверки подписи.
Подтверждайте заказы автоматически, без проверки выписок. Зарегистрируйтесь в Sila Pay