Create invoice (payment link) — for exchanger CMS

curl --request POST \ --url https://api.example.com/v1/public/invoices \ --header 'Content-Type: application/json' \ --header 'X-Signature: <api-key>' \ --data ' { "assetCode": "<string>", "amount": "100.50", "ttlMinutes": 60, "orderId": "<string>", "title": "<string>", "description": "<string>" } '

{ "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "orderId": "<string>", "token": "<string>", "payPath": "/invoice/abc123", "assetCode": "USDT_TRC20", "network": "TRON", "address": "<string>", "memo": "<string>", "amount": "100.50", "expiresAt": "2023-11-07T05:31:56Z" }

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

required

Сумма к оплате (decimal-строка).

Example:

"100.50"

ttlMinutes

number

default:60

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

Required range: 5 <= x <= 43200

orderId

string

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

title

string

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

description

string

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

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"

expiresAt

string<date-time>

required

status

enum<string>

required

Available options:

pending,

detected,

paid,

overpaid,

underpaid,

expired