Skip to main content
POST
Создать платёж (счёт на оплату)

Авторизации

X-Public-Id
string
header
обязательно

pk_live_… для платёжных эндпоинтов, wk_live_… для выплат/возвратов.

X-Signature
string
header
обязательно

hex(HMAC-SHA256(секрет, "\n<МЕТОД>\n<путь>\n<тело>"))

X-Timestamp
string
header
обязательно

Текущее время Unix в секундах (в пределах допустимого расхождения).

Тело

application/json
amount
string
обязательно

Сумма к оплате в валюте currency.

Пример:

"10"

currency
string
обязательно

Код валюты цены: любой из 23 фиатов (USD, EUR, RUB, …) или любая монета (USDT, BTC, …). У JPY и KRW ноль знаков после запятой.

Пример:

"USD"

accuracy_payment_percent
number

Допуск недо/переплаты, 0–5 %. Перекрывает настройку мерчанта.

additional_data
string

Приватные данные мерчанта, эхом в вебхуках (покупателю не видны).

is_payment_multiple
boolean

Разрешить доплату остатка.

is_refresh
boolean

Оживить просроченный счёт по order_id вместо создания нового.

lifetime
integer

Время жизни счёта в секундах, 300–43200; по умолчанию 3600. Значения вне диапазона обрезаются к ближайшей границе.

Пример:

3600

network
string

Сеть расчёта (напр. tron, ethereum). Необязательна — см. режимы выбора валюты и сети.

Пример:

"tron"

order_id
string

Ссылка мерчанта; ключ идемпотентности. Настоятельно рекомендуется.

Пример:

"order-1"

payer_email
string

Email плательщика. Если задан — после оплаты на него автоматически уходит чек; он же получатель по умолчанию у POST /v1/payment/send-email.

subtract
integer

Устаревшее: % сетевой наценки на плательщика (0–100); payer-facing наценки настраиваются через discount.

theme
string

Тема страницы оплаты: dark | light.

Пример:

"dark"

to_currency
string

Валюта расчёта — крипта, которой платят. По умолчанию = currency (только если currency — крипта); при цене в фиате задайте явно либо опустите вместе с network.

Пример:

"USDT"

url_callback
string

Индивидуальный webhook для этого счёта.

url_return
string

Ссылка «назад в магазин» на странице оплаты.

url_success
string

Редирект после успешной оплаты.

Ответ

200 - application/json

Success

result
object
state
integer
Пример:

0