Вебхуки
Уведомления о каждом изменении статуса на ваш сервер. Подписаны 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, используйте его для защиты от повторной обработки.