Общая информация

Atomic Pay Merchant API позволяет интегрировать криптовалютные платежи в ваш проект и управлять основными операциями программно.

С помощью API вы можете создавать и отслеживать счета, принимать платежи, работать со статическими кошельками, получать информацию о транзакциях и выполнять вывод средств.

Быстрый стартПолучите API-ключ и выставьте первый счёт.СчетаОплата фиксированной суммы в выбранной монете и сети.Статические кошелькиПостоянный адрес для любого числа пополнений.WebhooksУведомления об изменении счетов, пополнений и выводов.

Что можно делать через API

Управлять проектом — получать информацию о проекте, доступных валютах и балансах.
Получать список доступных монет и сетей.
Создавать счета и передавать клиенту данные для оплаты.
Отслеживать счета — получать статус и связанные blockchain-транзакции.
Отменять неоплаченные счета.
Создавать статические кошельки — отдельные адреса для приёма платежей.
Отслеживать пополнения и их подтверждения.
Получать историю транзакций проекта.
Создавать выводы средств через расчёт quoteId и отслеживать их статус.
Получать webhook-уведомления без постоянного опроса API.
Проверять доступность и готовность API.

Базовый адрес

Все адреса в документации указаны относительно базового адреса API:

https://api.atomic.wallet/api/v1

coinCode определяет криптовалюту, networkCode — блокчейн-сеть, в которой выполняется операция. Для монет, доступных в нескольких сетях, учитывайте оба параметра: USDT в Ethereum и USDT в TRON — разные активы с точки зрения API.

Поле	Описание	Значения
`coinCode`	Код криптовалюты	`BTC`, `ETH`, `USDT`, `LTC`, `DOGE`, `XMR`, `TRX`
`networkCode`	Код блокчейн-сети	`bitcoin`, `ethereum`, `tron`, `litecoin`, `dogecoin`, `monero`
Фиат	Валюта для расчётов и отображения стоимости	`USD`, `EUR`, `RUB`

[
  {
    "coinCode": "USDT",
    "networkCode": "ethereum"
  },
  {
    "coinCode": "USDT",
    "networkCode": "tron"
  }
]

Лимиты и комиссии

Минимумы, подтверждения и комиссии по монетам. Суммы указаны в единицах самой монеты.

Монета	Сеть	Мин. депозит	Мин. вывод	Подтверждения	Сервисная комиссия	Сетевая комиссия
BTC	bitcoin	0.0001	0.001	3	1%	0.00001
DOGE	dogecoin	10	0.001	2	1%	0.00001
ETH	ethereum	0.001	0.001	2	1%	0.00021
LTC	litecoin	0.01	0.001	6	1%	0.00001
TRX	tron	10	0.001	19	1%	1
USDT (ERC-20)	ethereum	5	0.001	2	1%	1
USDT (TRC-20)	tron	5	0.001	19	1%	1
XMR	monero	0.01	0.001	10	1%	0.001

Суммы передаются строками в основных единицах монеты (не minor units). Не используйте float.
Сервисная комиссия — 1%, сетевая оплачивается отдельно.
Для вывода serviceFee = 0, а debitAmount = recipientAmount + serviceFee + networkFee.
Кто платит комиссию, определяет настройка проекта feePayer.

Пагинация

Методы, которые возвращают списки, используют параметры limit и offset.

Параметры пагинации

Параметр	Тип	Обязательный	Описание
limit	integer	Нет	Сколько элементов вернуть. По умолчанию 20, от 1 до 100.
offset	integer	Нет	Сколько элементов пропустить. По умолчанию 0.

{
  "items": [],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 42
  }
}

Поле pagination.total содержит общее количество доступных элементов.

Сценарии

Сценарий	Шаги
Счёт	`POST /invoices` → клиент платит → подтверждения в сети → webhook `invoice.*`
Статический кошелёк	`POST /static-wallets` → клиент платит на адрес → `deposit.detected` / `deposit.confirmed`
Вывод	`POST /withdrawals/calculate` → `quoteId` → `POST /withdrawals` → `payout.requested` … `confirmed` \| `failed` \| `cancelled`

Далее →Доступные криптовалюты