Webhook заказов

Наша система имеет возможность уведомления об оплате либо возврата заказа.
Вам требуется добавить необходимый URL для отправки http-уведомлений на страницу интеграции мерчанта.

INFO

Уведомления отправляются только в случае успешной оплаты либо возврата (status: paid, hold, refund)

Запрос

Заголовоки запроса

Content-Type: application/json
X-Signature: {signature}

В заголовке X-Signature содержится сигнатура подтверждающая валидность (подробнее в инструкции по формированию сигнатуры).

Параметры запроса

Имя поля	Тип поля	Описание
invoice_id	string format: uuid	ID транзакции
order_id	string	ID платежа в вашей системе
amount	number format: double	Сумма заказа
currency	string enum: [RUB, UAH, USD, EUR]	Валюта заказа
credited	number format: double	Сумма зачисленная на баланс В случае возрата, это сумма которая списана с баланса
status	string enum: [paid, hold, refund]	Статус заказа. Оба статуса (paid, hold) считаются как успешная оплата заказа.
service	string	Метод оплаты
custom_fields	object examples: - {} - {"my_var": "5395"}	Дополнительные параметры пользователя

Пример параметров запроса:

{
	"amount": "3485.69",
	"credited": "3485.69",
	"currency": "RUB",
	"custom_fields": {
		"my_var": "5395"
	},
	"invoice_id": "31d85163-a038-4ad3-b9fa-e6fd544ed216",
	"order_id": "69a605342ef54",
	"service": "trx",
	"status": "paid"
}

Ответ от сервера

От вас нужен успешный HTTP ответ 200. Тело ответа не обязательно.
Рекомендуем так-же проверять IP сервера отправляющего Вам информацию, наши IP: 37.27.193.34, 159.69.50.37.

Рекомендация по обработке Webhook

В коде своего приложения учтите все требуемые проверки для защиты от повторных выдач услуг.
Т.е в случае повторного уведомления не выполнять действия повторно. Это поможет вам обезопасить свой бизнес

Так-же напоминаем, что у нас присутствует система возвратов. В случае если не была выдана или выполнена услуга: покупатель имеет право потребовать возврат. Учитывайте это в своем коде.