Один запрос к API — и покупатель получает страницу оплаты с QR-кодом. Платёж сопоставляется в блокчейне автоматически, а вы получаете вебхук.
Из них вы делаете только один.
Ваш сервер вызывает POST /api/invoice с суммой в фиате или USDT и получает ссылку на оплату.
На странице оплаты — точная сумма в USDT, QR-код и адрес. Курс зафиксирован на время жизни инвойса.
Finem видит транзакцию сразу («ждём подтверждения») и закрывает инвойс после подтверждения сетью TRON.
Уведомление со статусом и фактической суммой приходит на ваш callback — заказ можно выдавать.
Инвойсовая модель с автоматическим сопоставлением платежей в блокчейне — без ожидания оператора и ручной сверки.
Один POST-запрос — и у вас ссылка на оплату. Повторный запрос с тем же orderId безопасен: вернётся уже созданный инвойс.
Сумма, QR-код и адрес, таймер и живой статус. Кастомные ссылки возврата в магазин.
Платежи засчитываются только после подтверждения. Позднее подтверждение не теряется.
Комиссия биржи «съела» часть перевода? Небольшие недоплаты зачисляются сами, спорные уходят оператору.
Уведомление на каждую смену статуса, ретраи до часа, переотправка и тестовый вебхук.
Ордера со статусами и поиском, баланс, кошельки и очередь нераспознанных платежей для оператора — всё в веб-панели.
| Заказ | Сумма | Статус |
|---|---|---|
| shop-482 | 104,53 USDT | Success |
| shop-483 | 52,10 USDT | Pending |
| shop-484 | 18,00 USDT | WrongAmount |
Обычный REST и JSON — подойдёт любой язык. Выберите удобный путь.
merchant + sign, идемпотентность по orderId, фиат по зафиксированному курсу.# создаём инвойс
curl -X POST {baseUrl}/api/invoice \
-H "merchant: <Merchant ID>" -H "sign: <md5(base64(тело)+ApiKey)>" \
-d '{"amount":1000, "currency":"RUB",
"orderId":"shop-482",
"urlCallback":"https://shop.example/hook"}'
# ответ
{
"paymentUrl": "…/pay.html?pt=WtzAkHHVPP…",
"amountUsdt": 10.53,
"status": "Pending",
"expiresAt": "2026-07-05T12:00:00Z"
}
// sign = md5(base64(тело) + ApiKey)
$body = json_encode(['amount'=>1000, 'currency'=>'RUB',
'orderId'=>'shop-482',
'urlCallback'=>'https://shop.example/hook']);
$sign = md5(base64_encode($body) . $apiKey);
$ch = curl_init("$baseUrl/api/invoice");
curl_setopt_array($ch, [
CURLOPT_POST => true, CURLOPT_POSTFIELDS => $body, CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["merchant: $merchantId", "sign: $sign"],
]);
$invoice = json_decode(curl_exec($ch), true);
header('Location: ' . $invoice['paymentUrl']);
// sign = md5(base64(тело) + ApiKey)
const crypto = require('crypto');
const body = JSON.stringify({
amount: 1000, currency: 'RUB',
orderId: 'shop-482', urlCallback: 'https://shop.example/hook'
});
const sign = crypto.createHash('md5')
.update(Buffer.from(body).toString('base64') + apiKey).digest('hex');
const r = await fetch(`${baseUrl}/api/invoice`, {
method: 'POST', body, headers: { merchant: merchantId, sign }
});
const { paymentUrl } = await r.json();
Только то, что реально делает система.
orderId не создаёт дубль.Подробности — в документации API.
Сейчас принимаем USDT в сети TRON (TRC-20). Суммы можно выставлять в фиате (RUB, KZT, UZS и другие) — они конвертируются по курсу, зафиксированному на время жизни инвойса.
Транзакцию мы видим сразу и показываем статус «ждём подтверждения». Инвойс закрывается после подтверждения сетью TRON.
Небольшие недоплаты в пределах допуска зачисляются автоматически. Спорные суммы попадают оператору на разбор и не теряются.
Позднее подтверждение не теряется: платёж учитывается в пределах льготного окна после истечения инвойса.
Вебхук на каждую смену статуса. Доставка at-least-once, ретраи до часа (до 10 попыток), есть переотправка и тестовый вебхук.
Войдите в панель и создайте первый инвойс — дальше всё по документации API.