Webhooks

Служит для информирования о платеже: система отправляет запрос на веб-адрес мерчанта с информацией о платеже, а сервис торговца должен зафиксировать факт оплаты.

Вы можете установить URL вебхука для своего проекта в своем личном кабинете Settings → Projects settings → Action menu → Edit → Webhook url для депозитов / Webhook url для выплат → Ok

Body:

Name	Type	Description
id	string	ID заявки выплаты / пополнения
merchant_order_id	string	Уникальный id заявки на стороне мерчанта
status	string	Статус заявки пополнения / выплаты
real_income	string	Фактическая сумма зачисления заявки пополнения
amount	string	Сумма выплаты
create_dt	date	Дата создания заявки пополнения / выплаты
last_modified_dt	date	Дата изменения статуса заявки пополнения / выплаты
expected_income	string	Ожидаемая сумма зачисления заявки пополнения

Webhook's examples:

Withdrawals:

// Выплата создана и ожидает обработки с нашей стороны
{
  "id": "80f40ad1-2dee-4f19-abc0-6a53aa2acacd",
  "status": "BRAND_NEW",
  "amount": "5000.0",
  "merchant_order_id": "83c79373-84ba-44e5-934f-782758d0e2ef",
  "create_dt": "2025-07-02 12:03:05.925937",
  "last_modified_dt": "2025-07-02 12:03:05.926003"
}

// Выплата успешно обработана на нашей стороне
{
  "id": "80f40ad1-2dee-4f19-abc0-6a53aa2acacd",
  "status": "SUCCESSFULLY_FINISHED",
  "amount": "5000.0",
  "merchant_order_id": "83c79373-84ba-44e5-934f-782758d0e2ef",
  "create_dt": "2025-07-02 12:03:05.925937",
  "last_modified_dt": "2025-07-02 12:03:05.926003"
}

//Мы не смогли обработать вашу выплату.
{
  "id": "80f40ad1-2dee-4f19-abc0-6a53aa2acacd",
  "status": "CANCELED",
  "amount": "5000.0",
  "merchant_order_id": "83c79373-84ba-44e5-934f-782758d0e2ef",
  "create_dt": "2025-07-02 12:03:05.925937",
  "last_modified_dt": "2025-07-02 12:03:05.926003"
}

{
  "id": "80f40ad1-2dee-4f19-abc0-6a53aa2acacd",
  "status": "TIME_OUT",
  "amount": "5000.0",
  "merchant_order_id": "83c79373-84ba-44e5-934f-782758d0e2ef",
  "create_dt": "2025-07-02 12:03:05.925937",
  "last_modified_dt": "2025-07-02 12:03:05.926003"
}

Deposits:

{
  "id": "5d46d815-72b3-40a4-9fae-8bc047bcfc5a",
  "status": "AUTO_APPROVED",
  "real_income": "5000.0",
  "expected_income": "5000.0",
  "merchant_order_id": "28badfae-cdb2-4686-bec5-2aec13c3361a",
  "create_dt": "2025-07-02 11:20:41.764464",
  "last_modified_dt": "2025-07-02 11:21:19.613541"
}

Webhook signature:

Для подтверждения подлинности уведомлений PayGo, есть возможность вместе с данными отправлять поле signature.

Эта подпись вычисляется по алгоритму HMAC-SHA256 с использованием секретного ключа, выдаваемого при подключении проекта.

Поле signature формируется завязываясь на следующих параметрах:

Для Order

{
  "id": ...,
  "status": ...,
  "real_income": ...,
  "expected_income": ...,
  "merchant_order_id": ...,
  "create_dt": ...,
  "last_modified_dt": ...,
}

Для Withdrawal

Важно! Порядок полей для подписи имеет значение.