Вебхуки

Уведомления о каждом изменении статуса на ваш сервер. Подписаны HMAC, доставляются повторно до успешного ответа.

События

СобытиеКогда приходит
payment.succeededПлатёж зачислен
payment.failedПлатёж не прошёл
payment.expiredКлиент не оплатил вовремя
payment.canceledПлатёж отменён
payout.succeededВыплата выполнена
payout.failedВыплата не прошла
settlement.completedВывод в USDT отправлен, в теле хеш транзакции
settlement.failedВывод в USDT отменён или не прошёл

Проверка подписи

В заголовке PF-Signature приходит время и подпись. Считайте HMAC-SHA256 от строки timestamp.body своим секретом и сравните.

import crypto from "node:crypto";

function verify(req, secret) {
  const [t, v1] = req.headers["pf-signature"]
    .split(",").map(p => p.split("=")[1]);
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${t}.${req.rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
}

Повторная доставка

Ответьте кодом 2xx в течение 10 секунд. Если ответа нет, повторим через 1 минуту, 5 минут, 30 минут, 2 часа и 12 часов. Все попытки видны в журнале событий, событие можно отправить повторно через кабинет. Идентификатор события приходит в заголовке PF-Event-Id, используйте его для защиты от повторной обработки.