Вебхук уведомлений

Вебхук уведомлений позволяет клиентам автоматически получать обновления в реальном времени о событиях платежей, обработанных через нашу платформу. Интегрировав этот вебхук, вы можете оставаться в курсе транзакций без необходимости ручного опроса.

Настройка

Для настройки уведомлений о платежных событиях вам необходимо предоставить URL, на который наша платформа сможет отправлять HTTP POST запросы. Убедитесь, что предоставленный URL соответствует следующим требованиям:

• Доступность: URL должен быть общедоступным и способным обрабатывать HTTP POST запросы.
• Управление данными: Ваш сервер должен быть готов обрабатывать входящие запросы, содержащие данные о событиях в указанном формате.

Детали запроса

• Метод: POST

Данные, отправляемые в вебхуке

Данные будут отправлены в формате JSON со следующей структурой:

{
    "transactionDate": "2025-01-21 08:16:58",
    "transactionStatus": "canceled",
    "transactionId": "fdb5e7bc-XXXX-XXXX-XXXX-97259408af0d",
    "totalAmount": 53.75,
    "paymentMethod": "cash",
    "email": "testuser@gmail.com",
    "numeroOrden": "n/a",
    "merchantId": ""
}

Ожидаемый ответ от вебхука

Сервер клиента должен ответить с кодом состояния 200 OK, чтобы подтвердить успешное получение сообщения. Любой другой код состояния будет считаться ошибкой доставки, и отправка сообщения будет повторена.

Пример запроса POST

Указанная выше структура JSON будет отправлена в теле HTTP POST запроса на настроенный URL. Ниже приведён пример того, как будет выглядеть запрос:

POST /webhook-endpoint HTTP/1.1
Host: your-website.com
Content-Type: application/json

{
    "transactionDate": "2025-01-21 08:16:58",
    "transactionStatus": "canceled",
    "transactionId": "fdb5e7bc-XXXX-XXXX-XXXX-97259408af0d",
    "totalAmount": 53.75,
    "paymentMethod": "cash",
    "email": "testuser@gmail.com",
    "numeroOrden": "n/a",
    "merchantId": ""
}

Часто задаваемые вопросы (FAQ)

• ¿Что произойдёт, если мой сервер недоступен для получения уведомлений? Если наша платформа не получает успешный ответ (200 OK) от вашего сервера, мы повторим попытку отправки уведомления до трёх раз. Если все попытки окажутся неудачными, событие будет помечено как недоставленное, и уведомление будет отправлено на указанный контактный адрес электронной почты для вашей учётной записи.

Рекомендуем внедрить надёжное ведение журналов и мониторинг на вашем сервере для быстрого выявления и устранения потенциальных проблем.