ДОКУМЕНТАЦИЯ API
Криптоплатежи.
Просто подключить.
Получите адрес с уведомлениями об оплате, проверяйте подтверждения и переводите средства.
${URL}/api/v1Адрес и уведомления
Один запрос для адреса и callback.
Получите адрес для заказа и сразу укажите, куда присылать уведомления об оплате.
/accounts/{account}/addressesПараметры запроса
JSONcurrency- Валюта:
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.
Уведомление
{
"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 --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"
}
Перевести средства
На ваш адрес или другому получателю.
Передавайте сумму целым числом в минимальных единицах валюты. Комиссии сети и API добавляются сверху.
/accounts/{account}/transferПараметры запроса
JSONcurrency- Валюта перевода.
transfer-key- Ваш секретный ключ переводов.
destinationsaddress— получатель,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 --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 показывает количество подтверждений.
/accounts/{account}/history/{txid}Параметры запроса
Querytxid- TXID поступления: 64 шестнадцатеричных символа.
currency- Валюта транзакции. Для USDT TRC20 —
usdt@trx.
0 — блок ещё не привязан к поступлению. 1 и больше — число подтверждений на момент проверки.
Что ещё важно
Порог подтверждений для выдачи товара выбирает магазин. Перед выдачей сверьте адрес, валюту и сумму заказа.
Метод показывает обнаруженные поступления на адреса вашего аккаунта. 503 означает, что сейчас проверить транзакцию не удалось: повторите чтение позже. Эта ошибка не означает ноль подтверждений. 404 — поступление пока не найдено для этого аккаунта.
curl --get "${URL}/api/v1/accounts/${ACCOUNT_ID}/history/${TXID}" \
--data-urlencode 'currency=btc'
{
"confirmations": 20
}
Суммы — целые числа в минимальных единицах валюты. 1 BTC = 100 000 000 сатоши