Webhook (Уведомление о платеже)

Webhook - процедура отправки уведомления на Ваш сервер при наступлении определенного события с Инвойсом. После просроченной или успешной оплаты система отправит уведомление на данный URL.

Webhook считается успешно доставленным, если Ваш сервер вернул HTTP-код = 200. В случае неуспешной доставки, системой предусмотрены повторные отправки WebHook, которые отправляются со следующими интервалами:

• Запрос №1: сразу после оплаты

• Запрос №2: 1 минута

• Запрос №3: 5 минут

• Запрос №4: 10 минут

• Запрос №5: 60 минут

После 5-го запроса — новые больше не отправляются. Также после успешной доставки — последующие уведомления не отправляются.

Каждый ответ Вашего сервера на Webhook-сообщение сохраняется, и может быть просмотрен в разделе инвойсов. Указан заголовок ответа и его содержимое обрезанное до 5000 символов.

Основная информация

Метод	POST
Формат запроса	application/x-www-form-urlencoded; charset=UTF-8

Типы сообщений на WebHook:

Успешная оплата:

• event_type — paid

• retry_count — количество попыток повторной отправки сообщения на WebHook

• data

  • id — ID платежа

  • wallet — кошелёк, куда нужно произвести оплату

  • payer_wallet — кошелёк, с которого произведена оплата

  • transaction_id — ID транзакции в сети TRON

  • source_currency — Валюта, указанная Пользователем (если была передана валюта не USD)

  • source_amount — Сумма в валюте пользователя (если была передана валюта не USD)

  • final_amount — итоговая сумма к оплате (включая "хвост" и комиссию, если её оплачивает покупатель)

  • requested_amount — сумма к оплате запрошенная пользователем

  • status — статус платежа

  • client_reference_id — номер платежа в системе Пользователя API. Должен быть уникальным для каждого Инвойса в рамках Мерчанта

  • metadata — произвольная строка, указываемая пользователем при создании платежа

  • created_at — время создания платежа в unixtime

  • paid_at — дата обнаружения оплаты в unixtime

  • expire_at — время, когда счёт станет просрочен (наша система проверяет платеж в течение срока, установленного в настройках мерчанта — 40 минут после создания)

  • payer_amount_exchange_rate — курс конвертации из USD в выбранную крипто-валюту

  • network — Блокчейн-сеть в которой был совершен платеж, например (TRON, BSC, BTC)

  • payer_currency — Крипто-валюта в которой был совершен платеж, например (TRX, USDT, BTC)

  • payment_amount_usd — Сумма платежа в USD

  • commission — сумма комиссии сервиса

Истек срок оплаты:

• event_type — expired

• retry_count — количество попыток повторной отправки сообщения на WebHook

• data

  • id — ID платежа

  • wallet — кошелёк, куда нужно произвести оплату

  • status — статус платежа

  • client_reference_id — номер платежа в системе Пользователя API. Должен быть уникальным для каждого Инвойса в рамках Мерчанта

  • metadata — произвольная строка, указываемая пользователем при создании платежа

  • created_at — время создания платежа в unixtime

  • expire_at — время, когда счёт станет просрочен (помните, наша система проверяет платеж в течение срока, установленного в настройках мерчанта — от 15 до 90 минут после создания)

Оплата подтверждена вручную

• event_type — paid_manually - возникает при ручном подтверждении инвойса

• retry_count — количество попыток повторной отправки сообщения на WebHook

• data

  • id — ID платежа

  • wallet — кошелёк, куда нужно произвести оплату

  • payer_wallet — кошелёк, с которого произведена оплата

  • transaction_id — ID транзакции в сети TRON

  • source_currency — Валюта, указанная Пользователем (если была передана валюта не USD)

  • source_amount — Сумма в валюте пользователя (если была передана валюта не USD)

  • final_amount — итоговая сумма к оплате (включая "хвост" и комиссию, если её оплачивает покупатель)

  • requested_amount — сумма к оплате запрошенная пользователем

  • status — статус платежа

  • client_reference_id — номер платежа в системе Пользователя API. Должен быть уникальным для каждого Инвойса в рамках Мерчанта

  • metadata — произвольная строка, указываемая пользователем при создании платежа

  • created_at — время создания платежа в unixtime

  • paid_at — дата обнаружения оплаты в unixtime

  • expire_at — время, когда счёт станет просрочен (наша система проверяет платеж в течение срока, установленного в настройках мерчанта — 40 минут после создания)

  • payer_amount_exchange_rate — курс конвертации из USD в выбранную крипто-валюту

  • network — Блокчейн-сеть в которой был совершен платеж, например (TRON, BSC, BTC)

  • payer_currency — Крипто-валюта в которой был совершен платеж, например (TRX, USDT, BTC)

  • payment_amount_usd — Сумма платежа в USD

  • commission — сумма комиссии сервиса

Ручное проведение платежа доступно в личном кабинете пользователя. Для этого:

• перейдите по ссылке

• в списке инвойсов найдите нужный платеж

• нажмите на кнопку "Ручное проведение платежа"

•