ДОКУМЕНТАЦИЯ API

Криптоплатежи.
Просто подключить.

Получите адрес с уведомлениями об оплате, проверяйте подтверждения и переводите средства.

Валюта
${URL}/api/v1
Без ключа

Адрес и уведомления

Один запрос для адреса и callback.

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

POST/accounts/{account}/addresses

Параметры запроса

JSON
currency
Валюта: btc, ltc, trx или usdt@trx.
callback.url
HTTPS-адрес обработчика на вашем сайте.
callback.data
Ваши данные, например номер заказа. Необязательно.

Сохраните address вместе с заказом. В уведомлении придут TXID, сумма и confirmations.

Как обрабатывать уведомления

Callback задаётся для адреса при его создании. По умолчанию используется POST с JSON; callback.method также принимает GET. Если уведомления не нужны, callback можно не передавать.

Сохраните уведомление и проверьте поступление по API. Ответьте HTTP 200, с Content-Type: text/plain и телом ровно *ok*, включая звёздочки.

Если ответить *ok* на pending, уведомление confirmed уже не придёт. Подтверждение проверяйте методом «Статус TXID» либо не подтверждайте pending, пока не дождётесь нужного числа подтверждений.

Возможны повторы и изменение порядка уведомлений. Учитывайте поступление один раз по currency, input_transaction_hash, event_kind и position; изменения статуса проверяйте по API. Тело callback само по себе не доказывает оплату.

Каждый успешный POST создаёт новый адрес. Если ответ не пришёл, не повторяйте запрос автоматически. У TRX и USDT общий список адресов TRON.

Уведомление

JSON
{
  "account": "00000000000000000000000000000001",
  "currency": "btc",
  "value": 100000,
  "input_address": "YOUR_RECEIVING_ADDRESS",
  "confirmations": 1,
  "input_transaction_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "network": "mainnet",
  "event": "confirmed",
  "status": "confirmed",
  "event_kind": "utxo_output",
  "position": 0,
  "data": {
    "order_id": "ORDER_1001"
  }
}
cURL
curl --request POST \
  "${URL}/api/v1/accounts/${ACCOUNT_ID}/addresses" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "currency": "btc",
    "callback": {
      "url": "https://shop.example/callback",
      "data": {
        "order_id": "ORDER_1001"
      }
    }
  }'
Ответ
{
  "address": "YOUR_RECEIVING_ADDRESS"
}
Основные поля ответа
Нужен Transfer Key

Перевести средства

На ваш адрес или другому получателю.

Передавайте сумму целым числом в минимальных единицах валюты. Комиссии сети и API добавляются сверху.

0,001 BTC100 000 сатоши
POST/accounts/{account}/transfer

Параметры запроса

JSON
currency
Валюта перевода.
transfer-key
Ваш секретный ключ переводов.
destinations
address — получатель, amount — сумма в минимальных единицах, без дробной части.

Сохраните id из ответа. Если ответ не пришёл, сначала проверьте перевод — повторный POST может отправить средства ещё раз.

Комиссии и результат перевода

Для конкретной суммы укажите целое число в минимальных единицах валюты. Комиссии добавляются сверху; subtract-fee-from-amount: true вычитает их из суммы. Для одного получателя с 100% обе комиссии вычитаются автоматически.

fee: normal — обычная комиссия сети. fee-limit и processing-fee-limit задают максимальные комиссии сети и API. Без лимитов используются комиссии, рассчитанные перед переводом. addresses ограничивает списание вашими выбранными адресами.

success означает отправку в сеть; этот статус ещё не гарантирует подтверждений. У TRX/USDT сначала возможен pending, ещё без TXID. Комиссии USDT оплачиваются в USDT, а необходимый для исполнения TRX предоставляет платформа.

После тайм-аута или ошибки 500/503 проверьте сохранённую операцию. Отсутствие ID или ответ 404 ещё не доказывают отказ. Если результат неизвестен, обратитесь к менеджеру. У TRON бывает частичный перевод: часть средств уже отправлена, повторять POST нельзя.

cURL
curl --request POST \
  "${URL}/api/v1/accounts/${ACCOUNT_ID}/transfer" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "currency": "btc",
    "transfer-key": "YOUR_TRANSFER_KEY",
    "destinations": [
      {
        "address": "YOUR_DESTINATION_ADDRESS",
        "amount": 100000
      }
    ],
    "fee": "normal"
  }'
Ответ
{
  "id": "8312c94cb8d4a9025f7d1c783f2be9a446c0e837965219b46792ac8523d9f068",
  "status": "success",
  "txs": [
    "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  ]
}
Основные поля ответа
Без ключа

Количество подтверждений

Передайте TXID — получите confirmations.

Проверьте TXID поступления на ваш адрес. В ответе поле confirmations показывает количество подтверждений.

GET/accounts/{account}/history/{txid}

Параметры запроса

Query
txid
TXID поступления: 64 шестнадцатеричных символа.
currency
Валюта транзакции. Для USDT TRC20 — usdt@trx.

0 — блок ещё не привязан к поступлению. 1 и больше — число подтверждений на момент проверки.

Что ещё важно

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

Метод показывает обнаруженные поступления на адреса вашего аккаунта. 503 означает, что сейчас проверить транзакцию не удалось: повторите чтение позже. Эта ошибка не означает ноль подтверждений. 404 — поступление пока не найдено для этого аккаунта.

cURL
curl --get "${URL}/api/v1/accounts/${ACCOUNT_ID}/history/${TXID}" \
  --data-urlencode 'currency=btc'
Ответ
{
  "confirmations": 20
}
Основные поля ответа

Суммы — целые числа в минимальных единицах валюты. 1 BTC = 100 000 000 сатоши