Skip to main content
POST
Create invoice (payment link) — for exchanger CMS

Authorizations

X-Signature
string
header
required

HMAC-SHA256-Hex(timestamp + "." + raw_body, api_secret)

Body

application/json
assetCode
string
required

Код актива (TRX, USDT_TRC20, GRAM, USDT_TON, …).

amount
string

Сумма к оплате в АКТИВЕ (decimal-строка; строго > 0). Ровно одно из amount / amountUsd.

Example:

"100.50"

amountUsd
string

USD-пег: сумма счёта в долларах; крипто-сумма фиксируется по курсу на момент выставления. Ровно одно из amount / amountUsd. 409 PROVIDER_UNAVAILABLE если у оракула нет курса актива.

Example:

"50.00"

ttlMinutes
number
default:60

Срок действия в минутах (по умолчанию 60). После — счёт просрочен, ссылка живёт ещё 1 день.

Required range: 5 <= x <= 43200
orderId
string

Ваш order_id. Если не указан — сгенерируется. Уникален в рамках сайта.

title
string

Заголовок/назначение (показывается клиенту).

description
string

Описание (показывается клиенту).

sweepDestinationWalletUuid
string

UUID системного кошелька-получателя свипа после оплаты. Не указан → дефолтная маршрутизация. Кошелёк должен быть active, той же сети что актив, роли hot/admin/payout/cold.

urlReturn
string

Ссылка «Вернуться в магазин» на странице оплаты (http/https).

Example:

"https://shop.example/cart"

urlSuccess
string

Куда автоматически перенаправить клиента после подтверждённой оплаты (через 5 с, с кнопкой). Платформа добавит query: ?order_id=…&invoice=&status=paid|overpaid.

Example:

"https://shop.example/thanks"

urlCallback
string

Webhook-URL именно для этого счёта — события депозита счёта уйдут сюда вместо callback_url сайта (подпись тем же секретом сайта). Приватные адреса — по настройке webhook.allow_private_urls.

Example:

"https://shop.example/hooks/wallet"

theme
enum<string>

Тема страницы оплаты. По умолчанию — настройка сайта / auto.

Available options:
light,
dark,
auto
locale
enum<string>

Язык страницы оплаты. По умолчанию — настройка сайта / ru.

Available options:
ru,
en
accuracyPaymentPercent
number

1.4.0: допуск недоплаты (%) для депозита счёта.

Required range: 0 <= x <= 100
allowTopUp
boolean

1.4.0: режим доплаты — при недоплате клиент может дослать остаток на тот же адрес.

Response

201 - application/json
uuid
string<uuid>
required
orderId
string
required

Ваш order_id (или сгенерированный).

token
string
required

Публичный токен ссылки.

payPath
string
required

Путь страницы оплаты. Абсолютная ссылка: https://<ваш-домен-кошелька>{payPath}.

Example:

"/invoice/abc123"

assetCode
string
required
Example:

"USDT_TRC20"

network
string
required
Example:

"TRON"

address
string
required

Адрес для оплаты.

memo
string | null
required

Memo (для memo-based сетей).

amount
string
required
Example:

"100.50"

amountUsd
string | null
required

USD-пег счёта (null = счёт выставлен в активе).

expiresAt
string<date-time>
required
status
enum<string>
required
Available options:
pending,
detected,
paid,
overpaid,
underpaid,
underpaid_waiting,
refunded,
expired
payUrl
string | null
required

1.4.0: абсолютная ссылка на страницу оплаты (если оператор задал базовый адрес).

urlReturn
string | null
required
urlSuccess
string | null
required
urlCallback
string | null
required
theme
enum<string> | null
required
Available options:
light,
dark,
auto
locale
enum<string> | null
required
Available options:
ru,
en
receivedAmount
string | null
required

Полученная сумма (после детекции tx).

txhash
string | null
required
createdAt
string<date-time>
required