Перейти к содержимому

Сети и токены

Перед созданием инвойса или депозита выберите сеть и токен из API. Одного названия токена недостаточно: нужен его адрес в выбранной сети.

Окно терминала
curl 'https://platform.invoise.me/api/v1/networks'

Если нужны только цены, GET /api/v1/pricing возвращает комиссии, с которых новый мерчант начинает в каждой сети, реферальную скидку и цены карты — в долларах. Ему не нужны учётные данные, вызывать его может любой сайт, а ответ кэшируется на пять минут.

В ответе вам нужны:

Поле Назначение
chain_id ID сети.
family solana или tron для этих сетей; у EVM-сетей поля нет или оно равно evm.
tokens[].address адрес токена: контракт в EVM и Tron, mint в Solana.
tokens[].decimals число знаков после запятой.
tokens[].status готовность токена, если поле есть. Для реальных платежей используйте ready.
minimum_payment наименьшая сумма инвойса в этой сети, в целых токенах.

Публичный каталог описывает настроенные сети. У мерчанта может быть включена только часть из них: при настройке проверьте GET /api/v1/merchants/{merchant_id}/networks с токеном сессии или API-ключом магазина с правом read (ID мерчанта ключа есть в GET /api/v1/me). API отклонит создание инвойса или депозита, если сеть или токен недоступны.

Для Solana и Tron до первого инвойса у магазина нужно задать получателя. См. Solana и Tron.

Набор сетей и токенов меняется через настройки платформы. Получайте доступность, адреса и decimals из API при выборе актива; не храните собственный фиксированный список.

minimum_payment — целое число токенов, например "1". Инвойс меньше этой суммы вернёт 400 amount_below_minimum. Поле есть в обоих списках сетей. Значение отличается между сетями и может меняться, поэтому читайте его из API, а не храните в коде.

Сумма инвойса — строка с целым числом в минимальных единицах токена:

Знаков у токена 10 токенов в запросе
6 "10000000"
18 "10000000000000000000"

Не отправляйте "10.5". При 6 знаках 10,5 токена — это "10500000". Для расчётов используйте целые числа (BigInt в JavaScript): обычные числа с плавающей точкой могут терять точность.

Исключение — инвойс с несколькими токенами или сетями: ему передают десятичную сумму в токенах, например "10.5". См. несколько токенов или сетей.

Это общие комиссии, с которыми начинает новый мерчант; у разных мерчантов условия могут отличаться, поэтому свои получайте из API (ниже). Комиссия — 0,5% от каждого инвойса или каждого пейаута депозита, но не меньше минимальной комиссии сети и не больше $10. Минимум покрывает газ на ваш пейаут.

Сеть Комиссия Минимальная комиссия Максимальная комиссия Минимальный платёж
Ethereum 0,5% $1 $10 $10
Arbitrum 0,5% $0,05 $10 $1
Base 0,5% $0,03 $10 $1
Optimism 0,5% $0,03 $10 $1
Polygon 0,5% $0,05 $10 $1
BNB Chain 0,5% $0,05 $10 $1
Avalanche 0,5% $0,02 $10 $1
Solana 0,5% $1 $10 $2
Tron 0,5% $4,50 $10 $10

Например, $100 в Base стоят $0,50, $4 — минимальные $0,03, а $5 000 — $10 вместо $25.

Мерчант, пришедший по реферальной ссылке, начинает с 0,49%. У мерчанта остаются комиссии, с которыми он был создан, а Invoise может назначить индивидуальные условия, поэтому получайте условия своего магазина из API, как показано ниже.

Окно терминала
curl 'https://platform.invoise.me/api/v1/shops/{shop_id}/terms' \
-H 'Authorization: Bearer ivk_...'

Ответ содержит условия по каждой сети:

Поле Назначение
invoice и deposit комиссия: bps, minimum, maximum.
sweep_threshold сколько нужно накопить на депозитном адресе перед пейаутом.
minimum_sweep и maximum_sweep указанный API диапазон этого параметра.

bps — сотые доли процента: 50 bps = 0,5%. minimum и maximum комиссии выражены в единицах с восемнадцатью знаками независимо от токена: 10000000000000000 означает комиссию 0,01 токена. sweep_threshold — обычная сумма в токенах, например "1". Чтобы изменить порог, отправьте PATCH /api/v1/shops/{shop_id} с {"sweep_thresholds":{"<chain_id>":"25"}} в пределах minimum_sweep и maximum_sweep этой сети; значение вне диапазона вернёт 400 invalid_sweep_threshold.

Максимальная комиссия — не максимальная сумма платежа. Не смешивайте её с суммой инвойса и порогом пейаута депозитов.