Создать платёж (счёт на оплату)
Создаёт счёт и возвращает адрес + сумму к оплате и ссылку на страницу оплаты.
Как проще всего: передайте amount (сумма), currency (валюта цены, напр. USD), order_id (ваш номер заказа). Если укажете network и to_currency — сразу зафиксируется конкретная монета/сеть. Если НЕ укажете — получится валюто-агностичная ссылка: клиент сам выберет валюту и сеть на странице оплаты.
Цена и расчёт — разные вещи. currency говорит, сколько счёт СТОИТ: это может быть фиат (USD, EUR, RUB, GBP, JPY и ещё 18 валют) или любая монета. to_currency говорит, чем ПЛАТЯТ: только крипта. Фиата мы не храним, поэтому баланс, выплаты и возвраты всегда в монете — счёт на 5000 ₽ выставить можно, а получить за него можно USDT, TRX и т. д.
Отсюда правило: если цена в фиате, то to_currency либо задаётся явно, либо не задаётся вовсе — вместе с network (тогда монету выберет покупатель). Цена в фиате + одна лишь network, без монеты, вернёт payment.to_currency_required: вывести монету из рублей неоткуда.
У иены и воны (JPY, KRW) нет копеек — сумма пишется без дробной части ("10000", не "10000.00"). Полный список валют цены — в pricing_currencies у GET /v1/currencies.
Идемпотентность: повтор с тем же order_id вернёт тот же счёт (двойного счёта не будет).
Необязательные удобства: lifetime (сколько секунд живёт счёт, 300–43200), url_return/url_success (куда вернуть клиента), url_callback (куда слать вебхук), additional_data (ваши приватные данные), payer_email, accuracy_payment_percent (допуск недо/переплаты 0–5%), is_refresh (оживить просроченный счёт по order_id).
Авторизации
pk_live_… для платёжных эндпоинтов, wk_live_… для выплат/возвратов.
hex(HMAC-SHA256(секрет, "\n<МЕТОД>\n<путь>\n<тело>"))
Текущее время Unix в секундах (в пределах допустимого расхождения).
Тело
Сумма к оплате в валюте currency.
"10"
Код валюты цены: любой из 23 фиатов (USD, EUR, RUB, …) или любая монета (USDT, BTC, …). У JPY и KRW ноль знаков после запятой.
"USD"
Допуск недо/переплаты, 0–5 %. Перекрывает настройку мерчанта.
Приватные данные мерчанта, эхом в вебхуках (покупателю не видны).
Разрешить доплату остатка.
Оживить просроченный счёт по order_id вместо создания нового.
Время жизни счёта в секундах, 300–43200; по умолчанию 3600. Значения вне диапазона обрезаются к ближайшей границе.
3600
Сеть расчёта (напр. tron, ethereum). Необязательна — см. режимы выбора валюты и сети.
"tron"
Ссылка мерчанта; ключ идемпотентности. Настоятельно рекомендуется.
"order-1"
Email плательщика. Если задан — после оплаты на него автоматически уходит чек; он же получатель по умолчанию у POST /v1/payment/send-email.
Устаревшее: % сетевой наценки на плательщика (0–100); payer-facing наценки настраиваются через discount.
Тема страницы оплаты: dark | light.
"dark"
Валюта расчёта — крипта, которой платят. По умолчанию = currency (только если currency — крипта); при цене в фиате задайте явно либо опустите вместе с network.
"USDT"
Индивидуальный webhook для этого счёта.
Ссылка «назад в магазин» на странице оплаты.
Редирект после успешной оплаты.