Общая информация

Webhook — это своего рода метод обратной связи для получения платежной информации. При изменении статуса счета на url_callback, указанный при создании счета или в настройках площадки, отправляется POST-запрос.

Приоритетным Callback URL является тот, который был передан при создании ордера

Webhook будет ожидать от вашего сервера код 2**, в случае других кодов, он будет пытаться отправить запрос пока не получит положительный ответ, но не более 10 раз

Для безопасности принимаемых запросов с нашего сервиса обязательно установите проверку по IP адресу отправителя. Наши IP 139.59.79.57, 164.92.179.119

Каждый отправленный запрос в Header содержит Signature, который требуется проверять, на валидность, для исключения возможности атак. Алгоритм проверки валидности вы можете найти здесь

Request Example

     {
      type: string, // Тип платежа PayIn/PayOut
      uuid: string, // Уникальный идентификатор в нашей системе
      order_id: string, // Ваш идентификатор переданный при создании ордера
      lifetime: number | null, // Unix timestamp дата истечнии времени жизни
      amount: string, // Фиатная сумма созданного ордера
      payment_link: string | null, // Ссылка на платежный терминал
      fact_amount: string | null, // Фиатная сумма фактического исполнения ордера
      balance_change: string | null, // Сумма зачисленная/списанная на/с счет(а) площадки
      commission: string | null, // Сумма ушедшая в счет комисии  
      is_test: boolean, // Тестовый ордер или нет
      status: string, // Статус текущего ордера
      payment_type: string, // Код платежного метода
      refer: string | null, // Реквизиты получателя
      recipient_name: string | null, // ФИО получателя
      bank: string | null, // Код банка получателя
      currency: string, // Код валюты
      additional_data: string | null, // Extra info переданное при создании ордера 
      convert: {
        to_currency: string, // Код валюты или криптовалюты в которой будет произведенно зачисленние/списание с счета
        rate: string | null // Курс конвертации
      },
      extra: object | null, // Дополнительная информация по инвойсу
      created_at: string, // ISO-8601 Дата создания ордера
    }

---

Просмотреть, что ответил ваш сервер при отправке Webhook и какие именно данные передавал наш сервис вы можете в личном кабине. Для просмотра, вам необходимо перейти в раздел Операции, найти интересующий вас ордер, нажать на кнопку действий в самой правой колонке и выбрать из доступного списка кнопку Логи.