Приём платежей — криптовалюта и карта
Покупатель выбирает на кассе любую монету и сеть — биткоин, эфир, USDT, USDC — или платит обычной картой. Вам приходит та валюта, которую вы назначили. Ссылка на оплату ставится на сайт без единой строки кода; API нужен, только если сумма берётся из корзины.
1,5% с платежа. Кабинет открывается сразу, приём — после проверки.
settled — можно отгружать01 / Подключение
Кнопка со ссылкой закрывает большинство случаев. API нужен там, где цена считается на вашей стороне.
Без кода
Создаёте в кабинете, получаете ссылку, ставите кнопкой на сайт. Цена фиксированная или та, которую покупатель вводит сам.
Ценник бывает многоразовым — для товара в каталоге, и одноразовым — для счёта конкретному человеку. Одноразовый закрывается в тот момент, когда первый покупатель переходит к оплате: двое, открывшие ссылку одновременно, не заплатят дважды за один товар.
<a href="https://api.priem.io/pay/ВАШ-ЦЕННИК">
Оплатить криптовалютой
</a>Когда сумма из корзины
Ваш сервер создаёт платёж на нужную сумму и ведёт покупателя на полученную ссылку. Проект определяется ключом, поэтому в теле его указывать не нужно.
POST https://api.priem.io/v1/payments
Authorization: Bearer priem_…
{
"amount": "49.00",
"currency": "USD",
"idempotencyKey": "zakaz-12345"
}Ключ идемпотентности берите из номера заказа, а не из времени и не случайный. Повторный запрос с тем же ключом вернёт тот же платёж вместо второго счёта. Ключ из Date.now() не защищает ни от чего.
Оплата картой работает на той же кассе и настраивать её не нужно. Покупатель покупает биткоин у провайдера, тот приходит прямо на адрес счёта, платёж проводится как обычный.
Минимум для карты — 10 долларов. Ниже порога кнопка не показывается, и покупателю сказано почему.
02 / Деньги
Комиссий три, и только одна наша. Две остальные берёт сеть, и мы показываем их здесь, а не после подключения.
Нам, с каждого платежа
1,5%
Удерживается при зачислении и видна в коллбэке отдельным полем.
Сети, при выводе
≈1 USDT
Фиксированно в TRON, платите вы. Копить и выводить разом дешевле, чем по платежу.
Сети, при оплате
Платит покупатель
Сверх вашего ценника. Не зависит от суммы, поэтому на мелком чеке заметна.
| Чем платит | Чек $5 | Чек $30 | Чек $100 |
|---|---|---|---|
| USDT в BSC | +1,3% | +0,5% | +0,3% |
| USDT в TON | +9,3% | +1,8% | +0,8% |
| USDT в TRON | +16,3% | +3,0% | +1,1% |
| USDT в Ethereum | +19,5% | +3,5% | +1,3% |
Оговорка Ниже 10 долларов продавать через криптовалюту тяжело. На трёх долларах даже недорогая сеть съедает заметную долю, а TRON и Ethereum добавляют четверть цены. Если у вас мелкие тарифы — продавайте их пакетами. Мы говорим это до подключения, а не после первых брошенных заказов.
03 / Разработчикам
Создать платёж, дождаться коллбэка, проверить подпись, отгрузить по settled. Больше ничего не требуется.
// сырое тело, до разбора JSON:
// подпись считается по байтам
const expected = createHmac('sha256', secret)
.update(`${timestamp}.${rawBody}`)
.digest('hex');
if (!timingSafeEqual(a, b)) return res.sendStatus(401);
markOrderPaid(event.paymentId, event.creditedAmount);
res.sendStatus(200);{timestamp}.{тело}, заголовки X-Priem-Timestamp и X-Priem-Signature.GET /v1/payments/{id} отдаёт актуальное состояние всегда. Полагаться на один коллбэк не стоит.Состояния платежа
createdЗаведён, монета ещё не выбранаawaiting_paymentМонета выбрана, ждём переводаonramp_pendingПлатит картой, покупаем криптуdetectedПеревод виден в сетиconfirmingНабираются подтвержденияconvertingМеняем на вашу валютуsettledДеньги на вашем балансеunderpaidПрислали меньше нужногоexpiredСрок счёта вышелrefundedВозвращён покупателюОтгружайте заказ по settled и только по нему.
04 / Надёжность
Работа, которую не видно из кабинета, но из-за отсутствия которой теряют деньги.
Каждую ночь мы сходимся: всё, что мы должны мерчантам, против того, что фактически лежит у провайдера. Недостача останавливает выплаты автоматически — до выяснения, а не до утра.
Новый адрес кошелька становится доступен через сутки после добавления. Это единственное, что стоит между угнанным кабинетом и пустым счётом. Неприятно ровно один раз.
Курс дрогнул, кошелёк удержал своё — пришло чуть меньше. В пределах допуска (по умолчанию 1%) платёж всё равно закрывается, и вы получаете полную сумму ценника. Разницу берём мы.
Входы, ключи, адреса, выплаты и ценники пишутся в журнал по сквозному номеру. Пять неудачных попыток входа запирают учётную запись на пятнадцать минут.
05 / До того, как вы решите
Регистрация занимает минуту, настройка — около получаса, и почти всё это время уйдёт на обработчик коллбэка.