Документация API

Принимайте оплату в USDT и другой криптовалюте через REST API: создавайте счета, выдавайте постоянные адреса, получайте подписанные вебхуки и выводите средства.

Введение

API позволяет создавать счета на оплату криптовалютой, выдавать постоянные адреса для пополнений, получать уведомления о платежах и выводить средства. Все запросы — HTTPS, тела запросов и ответов — JSON в кодировке UTF-8.

Базовый URLhttps://paymeusd.com
  • Суммы передаются и возвращаются строками ("49.90"), чтобы не терять точность.
  • Даты — в формате ISO 8601, UTC.
  • Активы обозначаются как сеть:МОНЕТА: tron:USDT, bsc:USDT, bitcoin:BTC.

Быстрый старт

  1. Получите API-ключ. Зарегистрируйтесь и создайте ключ в кабинете: Интеграция → API-ключи.
  2. Создайте счёт запросом POST /v1/invoices и перенаправьте покупателя на payment_url.
  3. Примите вебхук invoice.paid на свой url_callback, проверьте подпись и выдайте заказ.

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

Аутентификация

Передавайте секретный ключ в заголовке Authorization:

Authorization: Bearer sk_live_9fQ…
  • sk_live_… — боевой ключ, sk_test_… — ключ тестового режима.
  • Ключ даёт полный доступ к аккаунту, включая выводы. Храните его только на сервере, никогда — в браузере или мобильном приложении.
  • Ключ показывается один раз при создании. Скомпрометированный ключ отзовите в кабинете — он перестанет работать сразу.

Ошибки

При ошибке API возвращает HTTP-код 4xx/5xx и тело:

{ "error": "insufficient_balance", "message": "недостаточно USDT на балансе (нужно 152 с комиссией)" }

error — стабильный машинный код, message — описание для людей (может меняться).

HTTPКодКогда
400validation_errorНеверные параметры запроса
400unsupported_currency, unknown_asset, asset_not_allowedВалюта или актив не поддерживаются
400invalid_address, amount_too_small, insufficient_balanceОшибки выплаты
401unauthorizedНет ключа, ключ неверный или отозван, аккаунт не активен
404not_foundОбъект не найден или принадлежит другому аккаунту
400invalid_idempotency_keyЗаголовок Idempotency-Key пустой, длиннее 255 символов или не из печатных символов ASCII
409order_existsТакой order_id уже есть с другими параметрами
409idempotency_in_progressЗапрос с этим Idempotency-Key ещё выполняется — повторите через несколько секунд
422idempotency_key_mismatchЭтот Idempotency-Key уже использован с другим запросом — нужен новый ключ
409invoice_lockedСчёт уже нельзя изменить или отменить
409nothing_to_refundПо счёту нечего возвращать: платежей нет или всё уже возвращено
400refund_too_largeСумма возврата больше полученной по счёту
400batch_invalidМассовая выплата не создана: ошибки в строках или не хватает баланса — разбор в details
403address_not_whitelisted, address_not_active_yetВключён белый список адресов вывода: адреса нет в списке или он ещё не заработал (новые — через 24 ч)
403refund_requires_cabinetПри включённом белом списке возвраты делаются только из кабинета
429rate_limitedСлишком много запросов — повторите через указанное в сообщении время
500internal_errorСбой на стороне сервиса — повторите позже; если повторяется, напишите в поддержку
503rate_unavailable, network_unavailableВременно нет курса или сеть недоступна — повторите позже

Идемпотентность

Любой POST-запрос к /v1/… можно безопасно повторить после сетевой ошибки или таймаута, если передать заголовок Idempotency-Key — уникальную строку, которую вы создаёте для каждой операции (удобно — UUID v4) и повторяете в каждой попытке этой операции:

POST /v1/payouts
Authorization: Bearer sk_live_9fQ…
Idempotency-Key: 5f0c8d1e-3b7a-4c2e-9f61-2a8d4e7b1c03
  • Первый запрос выполняется как обычно, а его ответ (код и тело) запоминается. Повтор с тем же ключом и теми же параметрами второй раз не выполняется: приходит сохранённый ответ с заголовком Idempotent-Replayed: true — второй счёт, выплата или возврат не создаются.
  • Ключ действует в пределах вашего аккаунта и хранится 24 часа, после этого его можно использовать снова.
  • Тот же ключ с другим методом, адресом или телом запроса — ошибка 422 idempotency_key_mismatch: для новой операции нужен новый ключ.
  • Пока первый запрос с этим ключом ещё выполняется, повтор получит 409 idempotency_in_progress — повторите через несколько секунд. Если первый запрос прервался из-за сбоя сервиса, ключ освобождается для повтора через пару минут.
  • Сохраняются ответы 2xx и 4xx: повтор вернёт ту же ошибку — исправьте запрос и отправьте его с новым ключом. Ответы 5xx не сохраняются: повтор с тем же ключом выполнит запрос заново.
  • Ключ — от 1 до 255 печатных символов ASCII, иначе 400 invalid_idempotency_key. В GET-запросах заголовок не нужен и не учитывается.
  • Официальные SDK (Node.js, Python, PHP) передают ключ сами и при сбое повторяют POST с тем же ключом.

Особенно рекомендуем ключ для выплат и возвратов — это движение денег.

Повтор по order_id

И без заголовка повторный запрос с тем же order_id и теми же параметрами не создаёт новый счёт или выплату, а возвращает существующий объект. Если параметры отличаются (другая сумма или адрес), API вернёт 409 order_exists.

Исключение — счета, которые истекли или отменены: они номер заказа не занимают. Если покупатель вернулся после истечения срока, создайте счёт с тем же order_id — придёт новый счёт с новым id (сумму можно изменить). Старые счета остаются в истории и находятся через GET /v1/invoices?order_id=….

Счета

Счёт — запрос на оплату определённой суммы. Покупатель открывает payment_url, выбирает монету и сеть и переводит деньги на уникальный адрес. Когда сеть подтверждает перевод, сумма за вычетом комиссии зачисляется на ваш баланс.

pending→confirming→paid
СтатусЗначение
pendingОжидает оплаты
confirmingПлатёж найден, ждём подтверждений сети
partialПолучена часть суммы, покупатель может доплатить до истечения срока
paid / paid_overОплачен полностью / с переплатой — можно выдавать заказ
underpaidСрок истёк, сумма получена не полностью
expiredСрок истёк без оплаты
cancelledОтменён вами

Платежи после истечения срока и платежи другой монетой тоже зачисляются на баланс — вы получите вебхук payment.confirmed с kind = late или unexpected.

Объект Invoice

Возвращается всеми методами счетов и приходит в вебхуках invoice.*.

idstring
ID счёта (UUID).
order_idstring
Ваш номер заказа. Среди неистёкших счетов уникален; после истечения или отмены можно создать новый счёт с тем же номером.
statusstring
Статус счёта: pending, confirming, partial, paid, paid_over, underpaid, expired, cancelled.
is_finalboolean
true — статус больше не изменится.
amountstring
Сумма счёта в валюте currency.
currencystring
Валюта счёта: фиат (USD, EUR…) или криптовалюта (USDT, BTC…).
amount_usdstring
Эквивалент суммы в долларах по курсу на момент выбора монеты.
descriptionstring | null
Описание, которое видит покупатель.
assetstring | null
Выбранный актив в формате сеть:МОНЕТА, например tron:USDT. null, пока покупатель не выбрал.
networkstring | null
ID сети (tron, ethereum, bsc…).
network_namestring | null
Название сети для людей.
symbolstring | null
Тикер выбранной монеты.
token_standardstring | null
Стандарт токена: TRC-20, ERC-20, BEP-20, SPL… null для нативных монет.
pay_amountstring | null
Сколько нужно отправить в выбранной монете.
paid_amountstring
Подтверждённая сеть сумма.
pending_amountstring
Найденная, но ещё не подтверждённая сумма.
remaining_amountstring | null
Сколько осталось доплатить.
addressstring | null
Адрес для оплаты — уникален для счёта (кроме TON).
memostring | null
Комментарий к переводу — обязателен для TON.
payment_uristring | null
Ссылка для QR-кода (bitcoin:, solana:, ton://) или адрес.
required_confirmationsinteger | null
Сколько подтверждений сети нужно для зачисления.
fee_levelstring | null
Уровень комиссии сети для покупателя: low, medium, high.
settle_secinteger | null
Примерное время до зачисления, секунд.
rate_usdstring | null
Курс выбранной монеты к USD, зафиксированный в момент выбора.
currency_is_fiatboolean
Валюта счёта — фиат.
payment_urlstring
Ссылка на страницу оплаты — отправьте на неё покупателя.
url_successstring | null
Куда вернуть покупателя после оплаты.
url_returnstring | null
Куда вернуть покупателя без оплаты.
expires_atstring
До какого момента можно оплатить (ISO 8601).
paid_atstring | null
Когда счёт оплачен.
created_atstring
Когда счёт создан.
metadataobject | null
Ваши данные, переданные при создании.
customerobject | null
Реквизиты покупателя для счёта и квитанции: {name, company, tax_id, address, email} (незаполненные — null). null — покупатель не указан. email — от магазина или указанный покупателем на странице оплаты.
documentsobject
Документы для покупателя — страницы для печати и сохранения в PDF на языке счёта (?lang= — другой язык): invoice_url — счёт на оплату (есть всегда), receipt_url — квитанция об оплате (null, пока счёт не оплачен: paid / paid_over). Ссылки — на ваш домен, если он подключён. Реквизиты продавца задаются в кабинете: «Оформление» → «Реквизиты для счетов и чеков».
regionstring | null
Регион ссылки на оплату, если задан при создании: ru или global. null — как в настройках магазина.
payment_urlsobject
Ссылка на страницу оплаты в каждом регионе, где у сервиса есть домен: {ru, global}. Удобно, если вы сами знаете страну покупателя. Пустой объект — домены по регионам не настроены.
langstring | null
Язык страницы оплаты, переданный при создании (en, ru, pt…). null — язык выбирается по браузеру покупателя.
buyer_countrystring | null
Страна клиента (ISO 3166-1 alpha-2), если задана при создании. null — страна определяется по покупателю.
p2p_methodsstring[] | null
Дополнительные способы оплаты счёта (если их подключил вам администратор сервиса): id способов, заданные при создании. null — все доступные, [] — без них.
p2p_currencystring
В какой валюте клиент платит дополнительными способами оплаты: invoice — только в валюте счёта, convert — в валюте клиента по курсу. Действующее значение: заданное при создании, иначе — из настроек магазина; если в валюте счёта таких способов нет — convert.
crypto_offboolean
true — оплата криптовалютой в этом счёте выключена (при создании передали crypto: false).
themestring | null
Тема страницы оплаты, если задана при создании: light или dark. null — как в оформлении магазина.
paymentsPayment[]
Входящие платежи по счёту.
refunded_amountstring
Сколько возвращено (и ещё возвращается) покупателю в монете счёта.
refundsPayout[]
Возвраты по счёту — объекты Payout с kind: "refund".
Пример
{
  "id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "order_id": "1001",
  "amount": "49.9",
  "currency": "EUR",
  "amount_usd": "55.24",
  "description": "Оплата заказа 1001",
  "currency_is_fiat": true,
  "payment_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "url_success": "https://shop.example/thanks",
  "url_return": null,
  "expires_at": "2026-11-13T10:04:05.253Z",
  "created_at": "2026-11-13T09:04:05.253Z",
  "metadata": {
    "user_id": 42
  },
  "lang": null,
  "region": null,
  "payment_urls": {
    "ru": "https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    "global": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"
  },
  "buyer_country": null,
  "p2p_methods": null,
  "p2p_currency": "convert",
  "crypto_off": false,
  "theme": null,
  "customer": {
    "name": null,
    "company": "Acme GmbH",
    "tax_id": "DE123456789",
    "address": null,
    "email": "[email protected]"
  },
  "documents": {
    "invoice_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
    "receipt_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/receipt"
  },
  "status": "paid",
  "is_final": true,
  "network": "tron",
  "network_name": "TRON",
  "token_standard": "TRC-20",
  "asset": "tron:USDT",
  "symbol": "USDT",
  "pay_amount": "55.24",
  "paid_amount": "55.24",
  "pending_amount": "0",
  "remaining_amount": "0",
  "address": "TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat",
  "memo": null,
  "payment_uri": "TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat",
  "required_confirmations": 19,
  "fee_level": "medium",
  "settle_sec": 57,
  "rate_usd": "1",
  "paid_at": "2026-11-13T09:05:28.416Z",
  "payments": [
    {
      "id": "82a1a806-9162-4a3f-9109-e927ed7d6206",
      "network": "tron",
      "network_name": "TRON",
      "asset": "tron:USDT",
      "currency": "USDT",
      "amount": "55.24",
      "tx_hash": "b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
      "from": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      "confirmations": 19,
      "required_confirmations": 19,
      "status": "confirmed",
      "kind": "invoice",
      "fee": "0.5524",
      "credited_amount": "54.6876",
      "explorer_url": "https://tronscan.org/#/transaction/b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
      "detected_at": "2026-11-13T09:04:31.112Z",
      "confirmed_at": "2026-11-13T09:05:28.416Z"
    }
  ],
  "refunded_amount": "0",
  "refunds": []
}

Создать счёт

POST/v1/invoices

Создаёт счёт и возвращает ссылку на страницу оплаты. Сумму можно указать в фиате — она будет пересчитана в выбранную покупателем монету по текущему курсу.

Тело запроса

amountstringобязательный
Сумма, например "49.90".
currencystringобязательный
Валюта суммы: USD, EUR, RUB, UAH, KZT, GBP, TRY или тикер монеты (USDT, BTC…).
order_idstringобязательный
Ваш уникальный номер заказа (до 128 символов). Обеспечивает идемпотентность.
lifetime_minutesinteger
Срок оплаты: от 5 до 43200 минут (30 дней). По умолчанию — 60. У счёта дольше суток сумма в монете действует 60 минут после выбора монеты: если покупатель вернётся позже, сумма пересчитается по текущему курсу; платёж, найденный позже чем через 30 минут после этого срока, засчитывается по курсу на момент зачисления.
assetstring
Сразу выбрать монету и сеть, например tron:USDT — покупатель увидит реквизиты без шага выбора.
allowed_assetsstring[]
Ограничить варианты оплаты, например ["tron:USDT","bsc:USDT"].
descriptionstring
Описание для покупателя (до 500 символов).
url_callbackstring
URL для вебхуков по этому счёту. По умолчанию — URL из кабинета.
url_successstring
Кнопка «Вернуться в магазин» после оплаты.
url_returnstring
Кнопка возврата без оплаты.
metadataobject
Произвольные данные — вернутся в ответах и вебхуках.
regionstring
Домены какого региона подставить в payment_url: ru — для покупателей из России (через сервер в РФ), global — для остальных (через Cloudflare). По умолчанию — как в настройке магазина «Где ваши покупатели».
langstring
Язык страницы оплаты: en, ru, uk, kk, uz, az, es, pt (Бразилия), fr, de, it, pl, tr, ar, fa, hi, id, vi, th, zh (упрощённый), ja, ko. Можно с регионом (pt-BR). Неподдерживаемый язык игнорируется. Покупатель может сменить язык на странице.
customerobject
Реквизиты покупателя для счёта на оплату и квитанции (все поля необязательны): name — контактное лицо (до 200 символов), company — компания (до 200), tax_id — налоговый номер: ИНН, VAT ID… (до 64), address — адрес (до 500), email — после оплаты на него придёт ссылка на квитанцию (один раз, на языке lang). Без email страница оплаты спросит его у покупателя до выбора способа оплаты и сохранит в customer.email.
buyer_countrystring
Страна клиента — код ISO 3166-1 из двух букв (RU, KZ…). Если вашему магазину подключены дополнительные способы оплаты по странам, покупатель увидит способы только этой страны — независимо от его IP и часового пояса.
p2p_methodsstring[]
Какие дополнительные способы оплаты показать (если они подключены вашему магазину): id или коды способов. Не передано — все доступные для страны покупателя, [] — без них.
p2p_currencystring
Дополнительные способы оплаты: invoice — только в валюте счёта, без пересчёта (счёт в долларах — оплата в долларах); convert — в валюте клиента по курсу (клиент из страны со своей валютой платит в ней). Не передано — как в настройках магазина (по умолчанию convert). Если в валюте счёта таких способов нет, действует convert.
cryptoboolean
false — без оплаты криптовалютой: только дополнительные способы оплаты, если они подключены (иначе — ошибка no_payment_methods). По умолчанию — true.
themestring
Тема страницы оплаты: light или dark. По умолчанию — как в оформлении магазина (кабинет → «Оформление»).

Ответ

Объект Invoice.

Ошибки

validation_error unsupported_currency unknown_asset invalid_country no_payment_methods order_exists rate_unavailable

Запрос
curl -X POST "https://paymeusd.com/v1/invoices" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": "49.90",
  "currency": "EUR",
  "order_id": "1001",
  "description": "Оплата заказа 1001",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_success": "https://shop.example/thanks",
  "metadata": {
    "user_id": 42
  },
  "customer": {
    "company": "Acme GmbH",
    "tax_id": "DE123456789",
    "email": "[email protected]"
  }
}'
const res = await fetch('https://paymeusd.com/v1/invoices', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "amount": "49.90",
    "currency": "EUR",
    "order_id": "1001",
    "description": "Оплата заказа 1001",
    "url_callback": "https://shop.example/webhooks/crypto",
    "url_success": "https://shop.example/thanks",
    "metadata": {
      "user_id": 42
    },
    "customer": {
      "company": "Acme GmbH",
      "tax_id": "DE123456789",
      "email": "[email protected]"
    }
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/invoices');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'amount' => "49.90",
      'currency' => "EUR",
      'order_id' => "1001",
      'description' => "Оплата заказа 1001",
      'url_callback' => "https://shop.example/webhooks/crypto",
      'url_success' => "https://shop.example/thanks",
      'metadata' => ['user_id' => 42],
      'customer' => ['company' => "Acme GmbH", 'tax_id' => "DE123456789", 'email' => "[email protected]"],
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/invoices",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "amount": "49.90",
        "currency": "EUR",
        "order_id": "1001",
        "description": "Оплата заказа 1001",
        "url_callback": "https://shop.example/webhooks/crypto",
        "url_success": "https://shop.example/thanks",
        "metadata": {
            "user_id": 42
        },
        "customer": {
            "company": "Acme GmbH",
            "tax_id": "DE123456789",
            "email": "[email protected]"
        }
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "order_id": "1001",
  "amount": "49.9",
  "currency": "EUR",
  "amount_usd": "55.24",
  "description": "Оплата заказа 1001",
  "currency_is_fiat": true,
  "payment_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "url_success": "https://shop.example/thanks",
  "url_return": null,
  "expires_at": "2026-11-13T10:04:05.253Z",
  "created_at": "2026-11-13T09:04:05.253Z",
  "metadata": {
    "user_id": 42
  },
  "lang": null,
  "region": null,
  "payment_urls": {
    "ru": "https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    "global": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"
  },
  "buyer_country": null,
  "p2p_methods": null,
  "p2p_currency": "convert",
  "crypto_off": false,
  "theme": null,
  "customer": {
    "name": null,
    "company": "Acme GmbH",
    "tax_id": "DE123456789",
    "address": null,
    "email": "[email protected]"
  },
  "documents": {
    "invoice_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
    "receipt_url": null
  },
  "status": "pending",
  "is_final": false,
  "network": null,
  "network_name": null,
  "token_standard": null,
  "asset": null,
  "symbol": null,
  "pay_amount": null,
  "paid_amount": "0",
  "pending_amount": "0",
  "remaining_amount": null,
  "address": null,
  "memo": null,
  "payment_uri": null,
  "required_confirmations": null,
  "fee_level": null,
  "settle_sec": null,
  "rate_usd": null,
  "paid_at": null,
  "payments": [],
  "refunded_amount": "0",
  "refunds": []
}

Получить счёт

GET/v1/invoices/{id}

Текущее состояние счёта со всеми платежами.

Параметры пути

idstringобязательный
ID счёта.

Ответ

Объект Invoice.

Ошибки

not_found

Запрос
curl "https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "order_id": "1001",
  "amount": "49.9",
  "currency": "EUR",
  "amount_usd": "55.24",
  "description": "Оплата заказа 1001",
  "currency_is_fiat": true,
  "payment_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "url_success": "https://shop.example/thanks",
  "url_return": null,
  "expires_at": "2026-11-13T10:04:05.253Z",
  "created_at": "2026-11-13T09:04:05.253Z",
  "metadata": {
    "user_id": 42
  },
  "lang": null,
  "region": null,
  "payment_urls": {
    "ru": "https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    "global": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"
  },
  "buyer_country": null,
  "p2p_methods": null,
  "p2p_currency": "convert",
  "crypto_off": false,
  "theme": null,
  "customer": {
    "name": null,
    "company": "Acme GmbH",
    "tax_id": "DE123456789",
    "address": null,
    "email": "[email protected]"
  },
  "documents": {
    "invoice_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
    "receipt_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/receipt"
  },
  "status": "paid",
  "is_final": true,
  "network": "tron",
  "network_name": "TRON",
  "token_standard": "TRC-20",
  "asset": "tron:USDT",
  "symbol": "USDT",
  "pay_amount": "55.24",
  "paid_amount": "55.24",
  "pending_amount": "0",
  "remaining_amount": "0",
  "address": "TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat",
  "memo": null,
  "payment_uri": "TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat",
  "required_confirmations": 19,
  "fee_level": "medium",
  "settle_sec": 57,
  "rate_usd": "1",
  "paid_at": "2026-11-13T09:05:28.416Z",
  "payments": [
    {
      "id": "82a1a806-9162-4a3f-9109-e927ed7d6206",
      "network": "tron",
      "network_name": "TRON",
      "asset": "tron:USDT",
      "currency": "USDT",
      "amount": "55.24",
      "tx_hash": "b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
      "from": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      "confirmations": 19,
      "required_confirmations": 19,
      "status": "confirmed",
      "kind": "invoice",
      "fee": "0.5524",
      "credited_amount": "54.6876",
      "explorer_url": "https://tronscan.org/#/transaction/b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
      "detected_at": "2026-11-13T09:04:31.112Z",
      "confirmed_at": "2026-11-13T09:05:28.416Z"
    }
  ],
  "refunded_amount": "0",
  "refunds": []
}

Список счетов

GET/v1/invoices

Счета от новых к старым. Удобно искать счёт по своему номеру заказа.

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

order_idstring
Найти счёт по вашему номеру заказа.
statusstring
Фильтр по статусу.
limitinteger
От 1 до 100, по умолчанию 20.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/invoices?order_id=1001" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/invoices?order_id=1001', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/invoices?order_id=1001');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/invoices?order_id=1001",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
      "order_id": "1001",
      "amount": "49.9",
      "currency": "EUR",
      "amount_usd": "55.24",
      "description": "Оплата заказа 1001",
      "currency_is_fiat": true,
      "payment_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
      "url_success": "https://shop.example/thanks",
      "url_return": null,
      "expires_at": "2026-11-13T10:04:05.253Z",
      "created_at": "2026-11-13T09:04:05.253Z",
      "metadata": {
        "user_id": 42
      },
      "lang": null,
      "region": null,
      "payment_urls": {
        "ru": "https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
        "global": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"
      },
      "buyer_country": null,
      "p2p_methods": null,
      "p2p_currency": "convert",
      "crypto_off": false,
      "theme": null,
      "customer": {
        "name": null,
        "company": "Acme GmbH",
        "tax_id": "DE123456789",
        "address": null,
        "email": "[email protected]"
      },
      "documents": {
        "invoice_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
        "receipt_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/receipt"
      },
      "status": "paid",
      "is_final": true,
      "network": "tron",
      "network_name": "TRON",
      "token_standard": "TRC-20",
      "asset": "tron:USDT",
      "symbol": "USDT",
      "pay_amount": "55.24",
      "paid_amount": "55.24",
      "pending_amount": "0",
      "remaining_amount": "0",
      "address": "TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat",
      "memo": null,
      "payment_uri": "TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat",
      "required_confirmations": 19,
      "fee_level": "medium",
      "settle_sec": 57,
      "rate_usd": "1",
      "paid_at": "2026-11-13T09:05:28.416Z",
      "payments": [
        {
          "id": "82a1a806-9162-4a3f-9109-e927ed7d6206",
          "network": "tron",
          "network_name": "TRON",
          "asset": "tron:USDT",
          "currency": "USDT",
          "amount": "55.24",
          "tx_hash": "b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
          "from": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
          "confirmations": 19,
          "required_confirmations": 19,
          "status": "confirmed",
          "kind": "invoice",
          "fee": "0.5524",
          "credited_amount": "54.6876",
          "explorer_url": "https://tronscan.org/#/transaction/b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
          "detected_at": "2026-11-13T09:04:31.112Z",
          "confirmed_at": "2026-11-13T09:05:28.416Z"
        }
      ],
      "refunded_amount": "0",
      "refunds": []
    }
  ]
}

Отменить счёт

POST/v1/invoices/{id}/cancel

Отменяет счёт в статусе pending, по которому ещё не было платежей.

Параметры пути

idstringобязательный
ID счёта.

Ответ

Объект Invoice.

Ошибки

not_found invoice_locked

Запрос
curl -X POST "https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "order_id": "1001",
  "amount": "49.9",
  "currency": "EUR",
  "amount_usd": "55.24",
  "description": "Оплата заказа 1001",
  "currency_is_fiat": true,
  "payment_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "url_success": "https://shop.example/thanks",
  "url_return": null,
  "expires_at": "2026-11-13T10:04:05.253Z",
  "created_at": "2026-11-13T09:04:05.253Z",
  "metadata": {
    "user_id": 42
  },
  "lang": null,
  "region": null,
  "payment_urls": {
    "ru": "https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    "global": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"
  },
  "buyer_country": null,
  "p2p_methods": null,
  "p2p_currency": "convert",
  "crypto_off": false,
  "theme": null,
  "customer": {
    "name": null,
    "company": "Acme GmbH",
    "tax_id": "DE123456789",
    "address": null,
    "email": "[email protected]"
  },
  "documents": {
    "invoice_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
    "receipt_url": null
  },
  "status": "cancelled",
  "is_final": true,
  "network": null,
  "network_name": null,
  "token_standard": null,
  "asset": null,
  "symbol": null,
  "pay_amount": null,
  "paid_amount": "0",
  "pending_amount": "0",
  "remaining_amount": null,
  "address": null,
  "memo": null,
  "payment_uri": null,
  "required_confirmations": null,
  "fee_level": null,
  "settle_sec": null,
  "rate_usd": null,
  "paid_at": null,
  "payments": [],
  "refunded_amount": "0",
  "refunds": []
}

Вернуть деньги покупателю

POST/v1/invoices/{id}/refund

Создаёт возврат по оплаченному счёту — выплату в той же монете и сети, в которой платил покупатель. Можно вернуть всё или часть; несколько частичных возвратов тоже можно, но в сумме не больше полученного. Сумма возврата и комиссия сети за отправку списываются с вашего баланса, комиссия сервиса за приём не возвращается. Дальше возврат идёт как обычная выплата (крупные — после проверки), статусы приходят вебхуками refund.*. Рекомендуем передавать заголовок Idempotency-Key (раздел «Идемпотентность»): тогда повтор запроса после сетевой ошибки не создаст второй возврат, даже без order_id.

Параметры пути

idstringобязательный
ID счёта.

Тело запроса

addressstringобязательный
Адрес покупателя в сети счёта. Спросите его у покупателя: адрес отправителя в блокчейне часто принадлежит бирже, и деньги туда не дойдут.
amountstring
Сумма в монете счёта. По умолчанию — всё, что ещё не возвращено.
memostring
Комментарий к переводу — нужен при возврате на биржу в TON.
reasonstring
Причина возврата — для вашей истории.
order_idstring
Ваш идентификатор возврата. С ним повторный запрос вернёт тот же возврат.
url_callbackstring
URL для вебхуков по этому возврату.

Ответ

Объект Payout.

Ошибки

not_found nothing_to_refund refund_too_large invalid_address amount_too_small insufficient_balance

Запрос
curl -X POST "https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/refund" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
  "reason": "Товар закончился"
}'
const res = await fetch('https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/refund', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
    "reason": "Товар закончился"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/refund');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'address' => "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      'reason' => "Товар закончился",
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/refund",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
        "reason": "Товар закончился"
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "id": "c3b1e0a2-5d4f-4e8a-9b7c-1f2e3d4c5b6a",
  "kind": "refund",
  "invoice_id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "batch_id": null,
  "reason": "Товар закончился",
  "order_id": "refund-1001-k3x9qa",
  "status": "queued",
  "network": "tron",
  "network_name": "TRON",
  "asset": "tron:USDT",
  "currency": "USDT",
  "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
  "memo": null,
  "amount": "55.24",
  "fee": "2",
  "total_debited": "57.24",
  "tx_hash": null,
  "explorer_url": null,
  "error": null,
  "created_at": "2026-11-13T09:04:05.395Z",
  "completed_at": null
}

Постоянные адреса

Постоянный адрес закрепляется за пользователем вашего сервиса: каждое поступление на него зачисляется на баланс и приходит вебхуком payment.confirmed с kind: "static" и вашим order_id. Подходит для пополнения баланса в играх, сервисах и кошельках — без создания счетов.

Объект StaticWallet

Постоянный адрес пользователя в одной сети.

idstring
ID постоянного адреса.
order_idstring
Ваш идентификатор пользователя.
networkstring
Сеть.
network_namestring
Название сети.
assetsstring[]
Монеты, которые принимаются на этот адрес.
addressstring
Адрес для пополнения.
memostring | null
Комментарий — обязателен для TON.
created_atstring
Когда создан.
Пример
{
  "id": "d20a74ce-7eab-4e3b-9258-8b0ce17807ac",
  "order_id": "user-42",
  "network": "tron",
  "network_name": "TRON",
  "assets": [
    "TRX",
    "USDT"
  ],
  "address": "THVC1jg4h9qkbU7STd1PGsrWzfXCJ5Z4es",
  "memo": null,
  "created_at": "2026-11-13T09:04:05.353Z"
}

Получить постоянный адрес

POST/v1/static-wallets

Возвращает адрес пользователя в сети. Повторный вызов с тем же order_id и сетью вернёт тот же адрес.

Тело запроса

networkstringобязательный
ID сети: tron, bsc, ethereum, solana, ton…
order_idstringобязательный
Ваш идентификатор пользователя.
url_callbackstring
URL для вебхуков по этому адресу.

Ответ

Объект StaticWallet.

Ошибки

network_unavailable

Запрос
curl -X POST "https://paymeusd.com/v1/static-wallets" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "network": "tron",
  "order_id": "user-42"
}'
const res = await fetch('https://paymeusd.com/v1/static-wallets', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "network": "tron",
    "order_id": "user-42"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/static-wallets');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'network' => "tron",
      'order_id' => "user-42",
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/static-wallets",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "network": "tron",
        "order_id": "user-42"
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "id": "d20a74ce-7eab-4e3b-9258-8b0ce17807ac",
  "order_id": "user-42",
  "network": "tron",
  "network_name": "TRON",
  "assets": [
    "TRX",
    "USDT"
  ],
  "address": "THVC1jg4h9qkbU7STd1PGsrWzfXCJ5Z4es",
  "memo": null,
  "created_at": "2026-11-13T09:04:05.353Z"
}

Платежи

Все входящие переводы на ваши адреса: оплаты счетов, пополнения постоянных адресов, поздние и «неожиданные» платежи.

Объект Payment

Входящий перевод в блокчейне.

idstring
ID платежа.
networkstring
Сеть, в которой пришёл перевод.
network_namestring
Название сети.
assetstring
Актив сеть:МОНЕТА.
currencystring
Тикер монеты.
amountstring
Сумма перевода.
tx_hashstring
Хеш транзакции.
fromstring | null
Адрес отправителя (если известен).
confirmationsinteger
Текущее число подтверждений.
required_confirmationsinteger
Сколько нужно для зачисления.
statusstring
pending — ждёт подтверждений, confirmed — зачислен, failed — откатился или выпал из сети.
kindstring
invoice — оплата счёта; static — пополнение постоянного адреса; unexpected — другая монета или сеть; late — после истечения счёта.
feestring | null
Комиссия сервиса (после зачисления).
credited_amountstring | null
Сколько зачислено на баланс за вычетом комиссии.
explorer_urlstring
Ссылка на транзакцию в обозревателе блоков.
detected_atstring
Когда платёж найден в сети.
confirmed_atstring | null
Когда зачислен.
Пример
{
  "id": "82a1a806-9162-4a3f-9109-e927ed7d6206",
  "network": "tron",
  "network_name": "TRON",
  "asset": "tron:USDT",
  "currency": "USDT",
  "amount": "55.24",
  "tx_hash": "b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
  "from": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
  "confirmations": 19,
  "required_confirmations": 19,
  "status": "confirmed",
  "kind": "invoice",
  "fee": "0.5524",
  "credited_amount": "54.6876",
  "explorer_url": "https://tronscan.org/#/transaction/b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
  "detected_at": "2026-11-13T09:04:31.112Z",
  "confirmed_at": "2026-11-13T09:05:28.416Z"
}

Список платежей

GET/v1/payments

Платежи от новых к старым. Кроме полей Payment содержат invoice_id и static_wallet_id.

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

kindstring
Фильтр: invoice, static, unexpected, late.
limitinteger
От 1 до 100, по умолчанию 50.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/payments" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/payments', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/payments');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/payments",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "id": "82a1a806-9162-4a3f-9109-e927ed7d6206",
      "network": "tron",
      "network_name": "TRON",
      "asset": "tron:USDT",
      "currency": "USDT",
      "amount": "55.24",
      "tx_hash": "b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
      "from": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      "confirmations": 19,
      "required_confirmations": 19,
      "status": "confirmed",
      "kind": "invoice",
      "fee": "0.5524",
      "credited_amount": "54.6876",
      "explorer_url": "https://tronscan.org/#/transaction/b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c",
      "detected_at": "2026-11-13T09:04:31.112Z",
      "confirmed_at": "2026-11-13T09:05:28.416Z",
      "invoice_id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
      "static_wallet_id": null
    }
  ]
}

Балансы

Баланс ведётся по монетам: USDT, полученный в разных сетях, суммируется. Вывести его можно в любой поддерживаемой сети.

Получить балансы

GET/v1/balances

Доступные для вывода суммы по каждой монете.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/balances" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/balances', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/balances');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/balances",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "currency": "USDT",
      "available": "1254.18"
    },
    {
      "currency": "BTC",
      "available": "0.01832"
    }
  ]
}

Выплаты

Выплата переводит средства с вашего баланса на внешний адрес. Сумма и комиссия списываются с баланса сразу при создании; если выплата будет отклонена или не пройдёт, деньги вернутся.

pending_approval→queued→processing→completed

Небольшие выплаты отправляются автоматически, крупные — после ручной проверки. Комиссия и минимальная сумма для каждой сети — в GET /v1/assets.

Объект Payout

Вывод средств на внешний адрес.

idstring
ID выплаты.
kindstring
payout — вывод с баланса; refund — возврат покупателю по счёту.
invoice_idstring | null
Для возврата — ID счёта.
batch_idstring | null
ID пакета, если выплата создана массовой выплатой.
reasonstring | null
Причина возврата, если указали.
order_idstring
Ваш идентификатор выплаты (идемпотентность).
statusstring
pending_approval → queued → processing → completed; также failed и rejected (деньги возвращаются на баланс).
networkstring
Сеть выплаты.
network_namestring
Название сети.
assetstring
Актив сеть:МОНЕТА.
currencystring
Тикер монеты.
addressstring
Адрес получателя.
memostring | null
Комментарий (для TON и бирж).
amountstring
Сумма, которую получит адресат.
feestring
Комиссия за вывод.
total_debitedstring
Списано с баланса: amount + fee.
tx_hashstring | null
Хеш транзакции после отправки.
explorer_urlstring | null
Ссылка на транзакцию.
errorstring | null
Причина отказа или ожидания.
created_atstring
Когда создана.
completed_atstring | null
Когда подтверждена сетью.
Пример
{
  "id": "41a6f86e-263f-4c35-bf06-f94ad715e04b",
  "kind": "payout",
  "invoice_id": null,
  "batch_id": null,
  "reason": null,
  "order_id": "withdraw-77",
  "status": "queued",
  "network": "tron",
  "network_name": "TRON",
  "asset": "tron:USDT",
  "currency": "USDT",
  "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
  "memo": null,
  "amount": "150",
  "fee": "2",
  "total_debited": "152",
  "tx_hash": null,
  "explorer_url": null,
  "error": null,
  "created_at": "2026-11-13T09:04:05.395Z",
  "completed_at": null
}

Создать выплату

POST/v1/payouts

Ставит выплату в очередь. Повтор с тем же order_id вернёт существующую выплату. Рекомендуем также передавать заголовок Idempotency-Key (раздел «Идемпотентность»): повтор после сетевой ошибки или таймаута вернёт тот же ответ и ничего не спишет повторно.

Тело запроса

networkstringобязательный
ID сети, например tron.
currencystringобязательный
Тикер монеты, например USDT.
addressstringобязательный
Адрес получателя в этой сети — формат проверяется.
amountstringобязательный
Сумма, которую получит адресат (комиссия добавится сверху).
order_idstringобязательный
Ваш уникальный идентификатор выплаты.
memostring
Комментарий — обязателен при выводе на биржу в TON.
url_callbackstring
URL для вебхуков по этой выплате.

Ответ

Объект Payout.

Ошибки

invalid_address amount_too_small insufficient_balance order_exists network_unavailable

Запрос
curl -X POST "https://paymeusd.com/v1/payouts" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "network": "tron",
  "currency": "USDT",
  "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
  "amount": "150",
  "order_id": "withdraw-77"
}'
const res = await fetch('https://paymeusd.com/v1/payouts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "network": "tron",
    "currency": "USDT",
    "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
    "amount": "150",
    "order_id": "withdraw-77"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/payouts');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'network' => "tron",
      'currency' => "USDT",
      'address' => "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      'amount' => "150",
      'order_id' => "withdraw-77",
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/payouts",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "network": "tron",
        "currency": "USDT",
        "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
        "amount": "150",
        "order_id": "withdraw-77"
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "id": "41a6f86e-263f-4c35-bf06-f94ad715e04b",
  "kind": "payout",
  "invoice_id": null,
  "batch_id": null,
  "reason": null,
  "order_id": "withdraw-77",
  "status": "queued",
  "network": "tron",
  "network_name": "TRON",
  "asset": "tron:USDT",
  "currency": "USDT",
  "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
  "memo": null,
  "amount": "150",
  "fee": "2",
  "total_debited": "152",
  "tx_hash": null,
  "explorer_url": null,
  "error": null,
  "created_at": "2026-11-13T09:04:05.395Z",
  "completed_at": null
}

Массовая выплата

POST/v1/payouts/batch

До 500 выплат одним запросом — зарплаты, партнёрские, выигрыши. Сначала проверяется каждая строка и хватает ли баланса по каждой монете; создаются либо все выплаты, либо ни одной (400 batch_invalid, разбор строк в details). С validate_only: true — только проверка. Дальше каждая выплата живёт как обычная: сверх дневного лимита — после одобрения. Повтор с тем же reference вернёт тот же пакет; без reference защищает от дубля заголовок Idempotency-Key (рекомендуем передавать всегда).

Тело запроса

itemsobject[]обязательный
Выплаты: network, currency, address, amount, по желанию memo и order_id (по умолчанию — <reference>-<номер>).
referencestring
Ваш идентификатор пакета для идемпотентности.
validate_onlyboolean
Только проверить, ничего не создавая: ответ 200 {valid, count, errors, rows, totals} — разбор строк и итоги по монетам с балансом.
url_callbackstring
URL для вебхуков payout.* по выплатам пакета.

Ответ

Объект со списком items.

Ошибки

batch_invalid batch_too_large batch_empty address_not_whitelisted

Запрос
curl -X POST "https://paymeusd.com/v1/payouts/batch" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reference": "salary-2026-11",
  "items": [
    {
      "network": "tron",
      "currency": "USDT",
      "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      "amount": "250"
    },
    {
      "network": "bsc",
      "currency": "USDT",
      "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "amount": "180"
    }
  ]
}'
const res = await fetch('https://paymeusd.com/v1/payouts/batch', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "reference": "salary-2026-11",
    "items": [
      {
        "network": "tron",
        "currency": "USDT",
        "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
        "amount": "250"
      },
      {
        "network": "bsc",
        "currency": "USDT",
        "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
        "amount": "180"
      }
    ]
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/payouts/batch');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'reference' => "salary-2026-11",
      'items' => ['0' => {"network":"tron","currency":"USDT","address":"TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5","amount":"250"}, '1' => {"network":"bsc","currency":"USDT","address":"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed","amount":"180"}],
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/payouts/batch",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "reference": "salary-2026-11",
        "items": [
            {
                "network": "tron",
                "currency": "USDT",
                "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
                "amount": "250"
            },
            {
                "network": "bsc",
                "currency": "USDT",
                "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
                "amount": "180"
            }
        ]
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "batch": {
    "id": "b1c2d3e4-0000-4000-8000-000000000001",
    "reference": "salary-2026-11",
    "source": "api",
    "count": 2,
    "totals": {
      "USDT": {
        "amount": "430",
        "fee": "3"
      }
    },
    "statuses": {
      "queued": 2
    },
    "created_at": "2026-11-13T09:04:05.395Z"
  },
  "items": [
    {
      "id": "41a6f86e-263f-4c35-bf06-f94ad715e04b",
      "kind": "payout",
      "invoice_id": null,
      "batch_id": "b1c2d3e4-0000-4000-8000-000000000001",
      "reason": null,
      "order_id": "salary-2026-11-1",
      "status": "queued",
      "network": "tron",
      "network_name": "TRON",
      "asset": "tron:USDT",
      "currency": "USDT",
      "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      "memo": null,
      "amount": "250",
      "fee": "2",
      "total_debited": "152",
      "tx_hash": null,
      "explorer_url": null,
      "error": null,
      "created_at": "2026-11-13T09:04:05.395Z",
      "completed_at": null
    }
  ]
}

Получить пакет выплат

GET/v1/payouts/batch/{id}

Итоги пакета и текущие статусы всех его выплат.

Параметры пути

idstringобязательный
ID пакета.

Ответ

Объект со списком items.

Ошибки

not_found

Запрос
curl "https://paymeusd.com/v1/payouts/batch/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/payouts/batch/6722fb9d-ed9e-4710-9f08-c9b63600b25a', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/payouts/batch/6722fb9d-ed9e-4710-9f08-c9b63600b25a');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/payouts/batch/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "batch": {
    "id": "b1c2d3e4-0000-4000-8000-000000000001",
    "reference": "salary-2026-11",
    "source": "api",
    "count": 2,
    "totals": {
      "USDT": {
        "amount": "430",
        "fee": "3"
      }
    },
    "statuses": {
      "completed": 1,
      "queued": 1
    },
    "created_at": "2026-11-13T09:04:05.395Z"
  },
  "items": [
    {
      "id": "41a6f86e-263f-4c35-bf06-f94ad715e04b",
      "kind": "payout",
      "invoice_id": null,
      "batch_id": "b1c2d3e4-0000-4000-8000-000000000001",
      "reason": null,
      "order_id": "salary-2026-11-1",
      "status": "queued",
      "network": "tron",
      "network_name": "TRON",
      "asset": "tron:USDT",
      "currency": "USDT",
      "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      "memo": null,
      "amount": "250",
      "fee": "2",
      "total_debited": "152",
      "tx_hash": null,
      "explorer_url": null,
      "error": null,
      "created_at": "2026-11-13T09:04:05.395Z",
      "completed_at": null
    }
  ]
}

Получить выплату

GET/v1/payouts/{id}

Текущий статус выплаты и хеш транзакции.

Параметры пути

idstringобязательный
ID выплаты.

Ответ

Объект Payout.

Ошибки

not_found

Запрос
curl "https://paymeusd.com/v1/payouts/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/payouts/6722fb9d-ed9e-4710-9f08-c9b63600b25a', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/payouts/6722fb9d-ed9e-4710-9f08-c9b63600b25a');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/payouts/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "id": "41a6f86e-263f-4c35-bf06-f94ad715e04b",
  "kind": "payout",
  "invoice_id": null,
  "batch_id": null,
  "reason": null,
  "order_id": "withdraw-77",
  "status": "completed",
  "network": "tron",
  "network_name": "TRON",
  "asset": "tron:USDT",
  "currency": "USDT",
  "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
  "memo": null,
  "amount": "150",
  "fee": "2",
  "total_debited": "152",
  "tx_hash": "7c0de4b1a9f2e8d3c6b5a4f7e2d1c9b8a6f5e4d3c2b1a0f9e8d7c6b5a4f3e2d1",
  "explorer_url": "https://tronscan.org/#/transaction/7c0de4b1a9f2e8d3c6b5a4f7e2d1c9b8a6f5e4d3c2b1a0f9e8d7c6b5a4f3e2d1",
  "error": null,
  "created_at": "2026-11-13T09:04:05.395Z",
  "completed_at": "2026-11-13T09:06:12.004Z"
}

Список выплат

GET/v1/payouts

Выплаты от новых к старым.

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

order_idstring
Найти выплату по вашему идентификатору.
statusstring
Фильтр по статусу.
limitinteger
От 1 до 100, по умолчанию 50.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/payouts" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/payouts', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/payouts');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/payouts",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "id": "41a6f86e-263f-4c35-bf06-f94ad715e04b",
      "kind": "payout",
      "invoice_id": null,
      "batch_id": null,
      "reason": null,
      "order_id": "withdraw-77",
      "status": "queued",
      "network": "tron",
      "network_name": "TRON",
      "asset": "tron:USDT",
      "currency": "USDT",
      "address": "TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5",
      "memo": null,
      "amount": "150",
      "fee": "2",
      "total_debited": "152",
      "tx_hash": null,
      "explorer_url": null,
      "error": null,
      "created_at": "2026-11-13T09:04:05.395Z",
      "completed_at": null
    }
  ]
}

Монеты и сети

Список поддерживаемых активов с параметрами: подтверждения, минимальные суммы, комиссии за вывод, текущие курсы. Таблица ниже — актуальные данные сервиса.

ID активаСетьЗнаковПодтв.≈ ЗачислениеМин. платёжВывод
bitcoin:BTCBitcoin8220 мин0.000010.0002
ethereum:ETHEthereum18122 мин0.000010.0005
ethereum:USDTEthereum ERC-206122 мин0.015
ethereum:USDCEthereum ERC-206122 мин0.015
bsc:BNBBNB Smart Chain181510 сек0.00010.0005
bsc:USDTBNB Smart Chain BEP-20181510 сек0.010.5
bsc:USDCBNB Smart Chain BEP-20181510 сек0.010.5
polygon:POLPolygon18321 мин0.010.5
polygon:USDTPolygon ERC-206321 мин0.010.5
polygon:USDCPolygon ERC-206321 мин0.010.5
arbitrum:ETHArbitrum One18205 сек0.000010.0005
arbitrum:USDTArbitrum One ERC-206205 сек0.010.5
arbitrum:USDCArbitrum One ERC-206205 сек0.010.5
optimism:ETHOptimism182040 сек0.000010.0005
optimism:USDTOptimism ERC-2062040 сек0.010.5
optimism:USDCOptimism ERC-2062040 сек0.010.5
base:ETHBase182040 сек0.000010.0005
base:USDCBase ERC-2062040 сек0.010.5
avalanche:AVAXAvalanche C-Chain1835 сек0.0010.02
avalanche:USDTAvalanche C-Chain ERC-20635 сек0.010.5
avalanche:USDCAvalanche C-Chain ERC-20635 сек0.010.5
plasma:XPLPlasma181010 сек0.010.5
plasma:USDTPlasma ERC-2061010 сек0.010.5
kaia:KAIAKaia1835 сек0.11
kaia:USDTKaia ERC-20635 сек0.010.5
celo:CELOCelo181010 сек0.10.5
celo:USDTCelo ERC-2061010 сек0.010.5
celo:USDCCelo ERC-2061010 сек0.010.5
kava:KAVAKava18320 сек0.10.5
kava:USDTKava ERC-206320 сек0.010.5
mantle:MNTMantle182040 сек0.10.5
mantle:USDTMantle ERC-2062040 сек0.010.5
tron:TRXTRON61955 сек11
tron:USDTTRON TRC-2061955 сек0.012
solana:SOLSolana93215 сек0.00010.005
solana:USDTSolana SPL63215 сек0.011
solana:USDCSolana SPL63215 сек0.011
ton:TONTON915 сек0.010.05
ton:USDTTON615 сек0.011

Серые строки — монеты, нужные только для газа: принимаются как «неожиданный» платёж, но не предлагаются покупателю.

Объект Asset

Монета в конкретной сети.

idstring
Идентификатор актива сеть:МОНЕТА.
symbolstring
Тикер.
namestring
Название монеты.
networkstring
ID сети.
network_namestring
Название сети.
standardstring | null
Стандарт токена.
contractstring | null
Адрес контракта токена.
decimalsinteger
Знаков после запятой в сети.
confirmationsinteger
Подтверждений до зачисления.
min_amountstring
Минимальная сумма платежа — меньшие игнорируются.
rate_usdstring | null
Текущий курс к USD.
payableboolean
Можно ли оплатить этой монетой счёт.
payout_feestring
Комиссия за вывод.
min_payoutstring
Минимальная сумма вывода.
Пример
{
  "id": "tron:USDT",
  "symbol": "USDT",
  "name": "Tether USD",
  "network": "tron",
  "network_name": "TRON",
  "standard": "TRC-20",
  "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "decimals": 6,
  "confirmations": 19,
  "min_amount": "0.01",
  "rate_usd": "1",
  "payable": true,
  "payout_fee": "2",
  "min_payout": "5"
}

Список активов

GET/v1/assets

Все активы, доступные сейчас для оплаты и вывода.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/assets" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/assets', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/assets');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/assets",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "id": "tron:USDT",
      "symbol": "USDT",
      "name": "Tether USD",
      "network": "tron",
      "network_name": "TRON",
      "standard": "TRC-20",
      "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "decimals": 6,
      "confirmations": 19,
      "min_amount": "0.01",
      "rate_usd": "1",
      "payable": true,
      "payout_fee": "2",
      "min_payout": "5"
    }
  ]
}

Актуальные домены

GET/v1/domains

Основной домен сервиса в каждом регионе: ru — для покупателей из России, global — для остальных. Если домен заблокируют, сервис переключится на резервный — этот метод всегда отдаёт текущий. Без API-ключа.

Ответ

JSON — пример справа.

Запрос
curl "https://paymeusd.com/v1/domains" \
  
const res = await fetch('https://paymeusd.com/v1/domains', {
  method: 'GET',
  headers: {
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/domains');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/domains",
    
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "regions": {
    "ru": {
      "active": "https://pay-shop.ru"
    },
    "global": {
      "active": "https://paymeusd.com"
    }
  },
  "fallback": "https://paymeusd.com"
}

Статус сервиса

GET/v1/status

Работает ли сервис прямо сейчас: API и страница оплаты, зачисление платежей, вебхуки, выплаты и каждая сеть. level: operational, degraded (задержки), outage, maintenance. Плюс открытые инциденты и плановые работы. То же для людей — страница /status, лента инцидентов — /status/feed.atom. Без API-ключа.

Ответ

JSON — пример справа.

Запрос
curl "https://paymeusd.com/v1/status" \
  
const res = await fetch('https://paymeusd.com/v1/status', {
  method: 'GET',
  headers: {
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/status');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/status",
    
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "status": {
    "level": "operational",
    "text": "Все системы работают"
  },
  "components": [
    {
      "id": "api",
      "group": "service",
      "name": "API и страница оплаты",
      "level": "operational",
      "level_text": "Работает"
    },
    {
      "id": "net:tron",
      "group": "networks",
      "name": "TRON",
      "level": "operational",
      "level_text": "Работает"
    }
  ],
  "incidents": {
    "active": [],
    "scheduled": [],
    "recent": []
  },
  "updated_at": "2026-11-13T09:04:05.000Z"
}

Валюты счёта

GET/v1/currencies

В каких валютах можно указать сумму счёта (currency в POST /v1/invoices): фиат по курсу и монеты подключённых сетей. Для монет указано, в каких сетях их можно принять.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/currencies" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/currencies', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/currencies');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/currencies",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "code": "USD",
      "type": "fiat",
      "name": "Доллар США",
      "rate_usd": "1",
      "networks": []
    },
    {
      "code": "EUR",
      "type": "fiat",
      "name": "Евро",
      "rate_usd": "1.1",
      "networks": []
    },
    {
      "code": "USDT",
      "type": "crypto",
      "name": "Tether USD",
      "rate_usd": "1",
      "networks": [
        "tron",
        "bsc",
        "ethereum",
        "solana",
        "ton"
      ]
    }
  ]
}

Регулярные платежи

Подписки на ваши услуги: SaaS, сервисы, абонементы. Криптовалюту нельзя списать автоматически, поэтому подписка — это расписание счетов, напоминания покупателю и статусы.

  1. Создайте тариф — POST /v1/plans: сумма и период, по желанию пробный период.
  2. Оформите подписку — POST /v1/subscriptions с email покупателя. Без пробного периода счёт за первый период выставляется сразу: отправьте покупателя на current_invoice.payment_url.
  3. Дальше всё само: заранее (по умолчанию за 3 дня) до конца оплаченного периода покупатель получает счёт на следующий период (письмом и в Telegram), за день — напоминание. Оплата продлевает подписку от конца текущего периода, вам приходит вебхук subscription.renewed.
pending / trialing→active→past_due→expired
СтатусЗначение
pendingЖдёт первой оплаты. Если её нет до конца льготного срока — expired
trialingПробный период; счёт за первый период приходит до его окончания
activeОплачена до current_period_end — предоставляйте услугу
past_dueПериод закончился, счёт не оплачен. Ждём grace_days дней (по умолчанию 3) — решите сами, продолжать ли услугу
cancelledОтменена: вами, покупателем на странице подписки или в конце периода после отмены продления
expiredНе оплачена до конца льготного срока
  • Счёт подписки — обычный счёт: у него order_id вида sub-<id подписки>-<номер периода> и metadata.billing_subscription_id, по нему приходят и вебхуки invoice.*. Деньги зачисляются на баланс как обычно.
  • Напоминания покупателю: письма (на русском или английском по locale) о новом счёте, за дни из настройки сервиса до срока, о просрочке и остановке подписки. На странице подписки (customer_url) покупатель может включить напоминания в Telegram.
  • Цена и период фиксируются при оформлении: изменение тарифа действует только на новые подписки.
  • Месячные периоды считаются от исходного дня: подписка от 31 января продлевается 28 (29) февраля, затем 31 марта.

Вебхуки подписок

Приходят на URL вебхуков из кабинета, подпись — как у остальных вебхуков. В data — объект Subscription; в событиях о счёте ещё и invoice (как current_invoice).

СобытиеКогда
subscription.createdПодписка оформлена
subscription.invoice_createdВыставлен счёт за следующий период (+ invoice)
subscription.renewedСчёт оплачен, период продлён (+ invoice)
subscription.past_dueПериод закончился, счёт не оплачен
subscription.cancel_scheduled, subscription.resumedПродление отменено / возобновлено (подписка действует до конца периода)
subscription.cancelledПодписка отменена
subscription.expiredНе оплачена до конца льготного срока

Объект Plan

Тариф: сумма и период.

idstring
ID тарифа (UUID).
namestring
Название — его видит покупатель в письмах и на странице подписки.
descriptionstring | null
Описание для покупателя.
amountstring
Сумма за один период.
currencystring
Валюта суммы: фиат (USD, EUR…) или монета (USDT…) — как у счетов.
intervalstring
Единица периода: day, week, month, year.
interval_countinteger
Сколько единиц в периоде: interval=month, interval_count=3 — раз в квартал.
trial_daysinteger
Пробный период в днях (0 — без пробного).
grace_daysinteger
Сколько дней после окончания периода ждём оплату (статус past_due), прежде чем остановить подписку.
allowed_assetsstring[] | null
Какими монетами можно платить, например ["tron:USDT","bsc:USDT"]. null — любыми.
archivedboolean
true — тариф в архиве: новые подписки нельзя, действующие продолжаются.
archived_atstring | null
Когда тариф отправлен в архив.
created_atstring
Когда тариф создан.
Пример
{
  "id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "name": "Pro",
  "description": "До 10 проектов и приоритетная поддержка",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_days": 14,
  "grace_days": 3,
  "allowed_assets": null,
  "archived": false,
  "archived_at": null,
  "created_at": "2026-11-13T09:00:00.000Z"
}

Объект Subscription

Подписка покупателя. Приходит в вебхуках subscription.*.

idstring
ID подписки (UUID).
statusstring
pending, trialing, active, past_due, cancelled, expired — см. таблицу выше.
plan_idstring
ID тарифа.
plan_namestring
Название тарифа.
order_idstring | null
Ваш идентификатор подписки из запроса создания.
customerobject
Покупатель: email, name, reference (ваш ID пользователя). На email приходят счета и напоминания.
localestring
Язык писем и страницы подписки: ru — русский, остальные — английский.
amountstring
Сумма за период — зафиксирована при оформлении: изменение тарифа её не меняет.
currencystring
Валюта суммы.
intervalstring
Единица периода: day, week, month, year.
interval_countinteger
Сколько единиц в периоде.
trial_endstring | null
Конец пробного периода.
period_numberinteger
Номер последнего оплаченного периода (0 — ещё ничего не оплачено).
current_period_startstring
Начало текущего периода (до первой оплаты — дата оформления).
current_period_endstring
До какого момента подписка оплачена (или конец пробного периода). Месячные периоды отсчитываются от исходного дня: 31 января → 28 (29) февраля → 31 марта.
next_payment_atstring | null
Срок следующей оплаты. null, если продление отменено или подписка закончилась.
cancel_at_period_endboolean
true — продление отменено: новых счетов не будет, в конце периода статус станет cancelled.
cancelled_atstring | null
Когда запрошена отмена.
ended_atstring | null
Когда подписка закончилась (cancelled или expired).
current_invoiceobject | null
Счёт за следующий период: id, status (статус счёта), period_number, amount, currency, due_at — срок оплаты, expires_at — конец льготного срока, payment_url.
customer_urlstring
Страница подписки для покупателя: оплатить счёт, история, напоминания в Telegram, отмена продления. Ссылка секретная — отправляйте её только покупателю.
metadataobject | null
Ваши данные, переданные при создании.
created_atstring
Когда подписка оформлена.
Пример
{
  "id": "b7e4c2a1-9d3f-4e8b-a5c6-0f1e2d3c4b5a",
  "status": "active",
  "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "plan_name": "Pro",
  "order_id": "user-42-pro",
  "customer": {
    "email": "[email protected]",
    "name": "Анна",
    "reference": "user-42"
  },
  "locale": "ru",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_end": "2026-11-27T09:00:00.000Z",
  "period_number": 1,
  "current_period_start": "2026-11-27T09:00:00.000Z",
  "current_period_end": "2026-12-27T09:00:00.000Z",
  "next_payment_at": "2026-12-27T09:00:00.000Z",
  "cancel_at_period_end": false,
  "cancelled_at": null,
  "ended_at": null,
  "current_invoice": {
    "id": "0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b",
    "status": "pending",
    "period_number": 2,
    "amount": "29",
    "currency": "USD",
    "due_at": "2026-12-27T09:00:00.000Z",
    "expires_at": "2026-12-30T09:00:00.000Z",
    "payment_url": "https://paymeusd.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
  },
  "customer_url": "https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
  "metadata": {
    "user_id": 42
  },
  "created_at": "2026-11-13T09:00:00.000Z"
}

Создать тариф

POST/v1/plans

Тариф задаёт сумму и период. Подписки оформляются на тариф.

Тело запроса

namestringобязательный
Название (до 120 символов).
amountstringобязательный
Сумма за период, например "29".
currencystringобязательный
Валюта: USD, EUR, RUB, UAH, KZT, GBP, TRY или тикер монеты (USDT…).
intervalstringобязательный
day, week, month или year.
interval_countinteger
Сколько единиц в периоде, по умолчанию 1. Не больше 365 дней, 260 недель, 60 месяцев, 5 лет.
trial_daysinteger
Пробный период, дней (0–365). По умолчанию 0.
grace_daysinteger
Льготный срок после окончания периода, дней (0–60). По умолчанию 3.
allowed_assetsstring[]
Ограничить монеты для оплаты, например ["tron:USDT","bsc:USDT"].
descriptionstring
Описание для покупателя (до 500 символов).

Ответ

Объект Plan.

Ошибки

validation_error unsupported_currency invalid_interval unknown_asset

Запрос
curl -X POST "https://paymeusd.com/v1/plans" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pro",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "trial_days": 14,
  "description": "До 10 проектов и приоритетная поддержка"
}'
const res = await fetch('https://paymeusd.com/v1/plans', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pro",
    "amount": "29",
    "currency": "USD",
    "interval": "month",
    "trial_days": 14,
    "description": "До 10 проектов и приоритетная поддержка"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/plans');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'name' => "Pro",
      'amount' => "29",
      'currency' => "USD",
      'interval' => "month",
      'trial_days' => 14,
      'description' => "До 10 проектов и приоритетная поддержка",
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/plans",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "name": "Pro",
        "amount": "29",
        "currency": "USD",
        "interval": "month",
        "trial_days": 14,
        "description": "До 10 проектов и приоритетная поддержка"
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "name": "Pro",
  "description": "До 10 проектов и приоритетная поддержка",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_days": 14,
  "grace_days": 3,
  "allowed_assets": null,
  "archived": false,
  "archived_at": null,
  "created_at": "2026-11-13T09:00:00.000Z"
}

Список тарифов

GET/v1/plans

Тарифы от новых к старым, архивные — в конце.

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

include_archivedstring
true — показать и архивные.
limitinteger
От 1 до 100, по умолчанию 50.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/plans" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/plans', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/plans');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/plans",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
      "name": "Pro",
      "description": "До 10 проектов и приоритетная поддержка",
      "amount": "29",
      "currency": "USD",
      "interval": "month",
      "interval_count": 1,
      "trial_days": 14,
      "grace_days": 3,
      "allowed_assets": null,
      "archived": false,
      "archived_at": null,
      "created_at": "2026-11-13T09:00:00.000Z"
    }
  ]
}

Получить тариф

GET/v1/plans/{id}

Тариф по ID.

Параметры пути

idstringобязательный
ID тарифа.

Ответ

Объект Plan.

Ошибки

not_found

Запрос
curl "https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "name": "Pro",
  "description": "До 10 проектов и приоритетная поддержка",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_days": 14,
  "grace_days": 3,
  "allowed_assets": null,
  "archived": false,
  "archived_at": null,
  "created_at": "2026-11-13T09:00:00.000Z"
}

Архивировать тариф

POST/v1/plans/{id}/archive

Новые подписки на тариф оформить будет нельзя. Действующие подписки продолжаются на прежних условиях.

Параметры пути

idstringобязательный
ID тарифа.

Ответ

Объект Plan.

Ошибки

not_found

Запрос
curl -X POST "https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a/archive" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a/archive', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a/archive');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a/archive",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "name": "Pro",
  "description": "До 10 проектов и приоритетная поддержка",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_days": 14,
  "grace_days": 3,
  "allowed_assets": null,
  "archived": true,
  "archived_at": "2026-12-01T10:00:00.000Z",
  "created_at": "2026-11-13T09:00:00.000Z"
}

Оформить подписку

POST/v1/subscriptions

Создаёт подписку на тариф. Без пробного периода счёт за первый период выставляется сразу — ссылка на оплату в current_invoice.payment_url, покупатель получит её и письмом. Повтор с тем же order_id вернёт существующую подписку (ответ 200).

Тело запроса

plan_idstringобязательный
ID тарифа.
customerobject
Покупатель: email — куда слать счета и напоминания, name, reference — ваш ID пользователя.
order_idstring
Ваш уникальный идентификатор подписки (до 128 символов). Обеспечивает идемпотентность.
localestring
Язык писем и страницы подписки: ru (по умолчанию) или en.
start_atstring
Начало подписки в будущем (ISO 8601), не позже чем через год. По умолчанию — сейчас.
metadataobject
Произвольные данные — вернутся в ответах и вебхуках.

Ответ

Объект Subscription.

Ошибки

validation_error plan_not_found plan_archived order_exists invalid_start

Запрос
curl -X POST "https://paymeusd.com/v1/subscriptions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "customer": {
    "email": "[email protected]",
    "name": "Анна",
    "reference": "user-42"
  },
  "order_id": "user-42-pro",
  "metadata": {
    "user_id": 42
  }
}'
const res = await fetch('https://paymeusd.com/v1/subscriptions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
    "customer": {
      "email": "[email protected]",
      "name": "Анна",
      "reference": "user-42"
    },
    "order_id": "user-42-pro",
    "metadata": {
      "user_id": 42
    }
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/subscriptions');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'plan_id' => "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
      'customer' => ['email' => "[email protected]", 'name' => "Анна", 'reference' => "user-42"],
      'order_id' => "user-42-pro",
      'metadata' => ['user_id' => 42],
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/subscriptions",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
        "customer": {
            "email": "[email protected]",
            "name": "Анна",
            "reference": "user-42"
        },
        "order_id": "user-42-pro",
        "metadata": {
            "user_id": 42
        }
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "id": "b7e4c2a1-9d3f-4e8b-a5c6-0f1e2d3c4b5a",
  "status": "pending",
  "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "plan_name": "Pro",
  "order_id": "user-42-pro",
  "customer": {
    "email": "[email protected]",
    "name": "Анна",
    "reference": "user-42"
  },
  "locale": "ru",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_end": null,
  "period_number": 0,
  "current_period_start": "2026-11-13T09:00:00.000Z",
  "current_period_end": "2026-11-13T09:00:00.000Z",
  "next_payment_at": "2026-11-13T09:00:00.000Z",
  "cancel_at_period_end": false,
  "cancelled_at": null,
  "ended_at": null,
  "current_invoice": {
    "id": "0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b",
    "status": "pending",
    "period_number": 1,
    "amount": "29",
    "currency": "USD",
    "due_at": "2026-11-13T09:00:00.000Z",
    "expires_at": "2026-11-16T09:00:00.000Z",
    "payment_url": "https://paymeusd.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
  },
  "customer_url": "https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
  "metadata": {
    "user_id": 42
  },
  "created_at": "2026-11-13T09:00:00.000Z"
}

Список подписок

GET/v1/subscriptions

Подписки от новых к старым.

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

statusstring
Фильтр по статусу.
plan_idstring
Подписки одного тарифа.
order_idstring
Найти по вашему идентификатору.
customer_emailstring
Подписки покупателя по email.
limitinteger
От 1 до 100, по умолчанию 20.
offsetinteger
Сколько пропустить — для постраничного просмотра.

Ответ

Объект со списком items.

Запрос
curl "https://paymeusd.com/v1/subscriptions?customer_email=anna%40example.com" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/subscriptions?customer_email=anna%40example.com', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/subscriptions?customer_email=anna%40example.com');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/subscriptions?customer_email=anna%40example.com",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "items": [
    {
      "id": "b7e4c2a1-9d3f-4e8b-a5c6-0f1e2d3c4b5a",
      "status": "active",
      "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
      "plan_name": "Pro",
      "order_id": "user-42-pro",
      "customer": {
        "email": "[email protected]",
        "name": "Анна",
        "reference": "user-42"
      },
      "locale": "ru",
      "amount": "29",
      "currency": "USD",
      "interval": "month",
      "interval_count": 1,
      "trial_end": "2026-11-27T09:00:00.000Z",
      "period_number": 1,
      "current_period_start": "2026-11-27T09:00:00.000Z",
      "current_period_end": "2026-12-27T09:00:00.000Z",
      "next_payment_at": "2026-12-27T09:00:00.000Z",
      "cancel_at_period_end": false,
      "cancelled_at": null,
      "ended_at": null,
      "current_invoice": {
        "id": "0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b",
        "status": "pending",
        "period_number": 2,
        "amount": "29",
        "currency": "USD",
        "due_at": "2026-12-27T09:00:00.000Z",
        "expires_at": "2026-12-30T09:00:00.000Z",
        "payment_url": "https://paymeusd.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
      },
      "customer_url": "https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
      "metadata": {
        "user_id": 42
      },
      "created_at": "2026-11-13T09:00:00.000Z"
    }
  ]
}

Получить подписку

GET/v1/subscriptions/{id}

Текущее состояние подписки и счёт за следующий период.

Параметры пути

idstringобязательный
ID подписки.

Ответ

Объект Subscription.

Ошибки

not_found

Запрос
curl "https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
  -H "Authorization: Bearer $API_KEY"
const res = await fetch('https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "id": "b7e4c2a1-9d3f-4e8b-a5c6-0f1e2d3c4b5a",
  "status": "active",
  "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "plan_name": "Pro",
  "order_id": "user-42-pro",
  "customer": {
    "email": "[email protected]",
    "name": "Анна",
    "reference": "user-42"
  },
  "locale": "ru",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_end": "2026-11-27T09:00:00.000Z",
  "period_number": 1,
  "current_period_start": "2026-11-27T09:00:00.000Z",
  "current_period_end": "2026-12-27T09:00:00.000Z",
  "next_payment_at": "2026-12-27T09:00:00.000Z",
  "cancel_at_period_end": false,
  "cancelled_at": null,
  "ended_at": null,
  "current_invoice": {
    "id": "0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b",
    "status": "pending",
    "period_number": 2,
    "amount": "29",
    "currency": "USD",
    "due_at": "2026-12-27T09:00:00.000Z",
    "expires_at": "2026-12-30T09:00:00.000Z",
    "payment_url": "https://paymeusd.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
  },
  "customer_url": "https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
  "metadata": {
    "user_id": 42
  },
  "created_at": "2026-11-13T09:00:00.000Z"
}

Отменить подписку

POST/v1/subscriptions/{id}/cancel

Сразу (по умолчанию) или в конце оплаченного периода. Неоплаченный счёт за следующий период отменяется. Подписку без оплаченного периода (pending, past_due) отменяет сразу. Повтор ничего не меняет.

Параметры пути

idstringобязательный
ID подписки.

Тело запроса

at_period_endboolean
true — отменить продление: подписка действует до current_period_end, затем cancelled.

Ответ

Объект Subscription.

Ошибки

not_found

Запрос
curl -X POST "https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "at_period_end": true
}'
const res = await fetch('https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "at_period_end": true
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'at_period_end' => true,
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "at_period_end": True
    },
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "id": "b7e4c2a1-9d3f-4e8b-a5c6-0f1e2d3c4b5a",
  "status": "active",
  "plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
  "plan_name": "Pro",
  "order_id": "user-42-pro",
  "customer": {
    "email": "[email protected]",
    "name": "Анна",
    "reference": "user-42"
  },
  "locale": "ru",
  "amount": "29",
  "currency": "USD",
  "interval": "month",
  "interval_count": 1,
  "trial_end": "2026-11-27T09:00:00.000Z",
  "period_number": 1,
  "current_period_start": "2026-11-27T09:00:00.000Z",
  "current_period_end": "2026-12-27T09:00:00.000Z",
  "next_payment_at": null,
  "cancel_at_period_end": true,
  "cancelled_at": "2026-12-01T10:00:00.000Z",
  "ended_at": null,
  "current_invoice": null,
  "customer_url": "https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
  "metadata": {
    "user_id": 42
  },
  "created_at": "2026-11-13T09:00:00.000Z"
}

Bitcoin Lightning

Сеть lightning, монета BTC (актив lightning:BTC). Платёж зачисляется за секунды, комиссия сети для покупателя — доли цента. Баланс общий с обычным BTC: полученное через Lightning можно вывести и в сети Bitcoin, и наоборот.

Приём

  • Когда покупатель выбирает lightning:BTC (или вы передаёте asset при создании счёта), шлюз создаёт Lightning-инвойс на pay_amount. В счёте address — сам инвойс (строка BOLT11 lnbc…, 200–400 символов), payment_uri — lightning:lnbc… для QR и кнопки «Открыть в кошельке», memo — null.
  • Инвойс на точную сумму и действует до конца срока счёта: недоплаты не бывает, а после срока оплатить его нельзя. Если покупатель сменит монету и вернётся к Lightning — будет новый инвойс.
  • Оплата окончательна сразу: required_confirmations = 1, статус счёта переходит в paid без промежуточного ожидания. В платеже tx_hash — payment hash инвойса, explorer_url пустой (у Lightning нет публичного обозревателя).
  • Постоянных адресов в Lightning нет: POST /v1/static-wallets с network: "lightning" вернёт 400 not_supported.

Выплаты

В POST /v1/payouts укажите network: "lightning", currency: "BTC" и в address — один из вариантов:

  • Lightning Address вида [email protected] — удобнее всего: шлюз сам запросит у кошелька получателя инвойс на нужную сумму (LNURL-pay) и проверит его.
  • BOLT11-инвойс получателя. Сумма в инвойсе должна точно совпадать с amount; инвойс без суммы оплачивается на amount. Инвойс одноразовый: оплатить его второй раз нельзя, а у просроченного выплата не пройдёт.

Если инвойс не подходит (другая сумма, истёк, кошелёк получателя не ответил) или платёж не нашёл маршрут, выплата получает статус failed с причиной в error, а сумма и комиссия возвращаются на баланс. tx_hash выплаты — payment hash. Комиссия за вывод — фиксированная, см. payout_fee в GET /v1/assets; комиссию маршрута платит шлюз.

Кнопки оплаты и виджет

Кнопка оплаты — как Payment Link: создайте её в кабинете (Кнопки оплаты) и получите ссылку https://paymeusd.com/b/КОД для соцсетей и мессенджеров и код кнопки для любого сайта. Сумма — фиксированная или её вводит покупатель (донаты, пополнения, оплата по счёту) с минимумом и максимумом. Каждое нажатие создаёт обычный счёт с order_id вида btn-КОД-… — оплату видно в разделе «Счета», а на ваш URL приходят те же вебхуки invoice.*. Email и комментарий покупателя — в metadata счёта: {"button": "КОД", "email": "…", "comment": "…"}.

Кнопка на сайт — одна строка

<script src="https://paymeusd.com/widget.js" data-button="КОД" async></script>

Кнопка появится там, где стоит тег. Несколько кнопок на странице — разметка <div data-cp-button="КОД"></div> и один тег <script src="https://paymeusd.com/widget.js" async></script> в конце страницы (кнопки, добавленные скриптами сайта позже, тоже появятся).

АтрибутЗначение
data-themelight (по умолчанию) или dark — для тёмного сайта
data-langru или en; по умолчанию — язык страницы
data-labelСвой текст кнопки, например «Поддержать проект»
  • Кнопка рисуется в Shadow DOM: стили сайта её не ломают, а её стили не задевают сайт. Работает при строгом CSP сайта, если разрешены script-src и connect-src для https://paymeusd.com.
  • По нажатию создаётся счёт, и страница оплаты открывается в новом окне на компьютере и в новой вкладке на телефоне. Если всплывающие окна запрещены — в той же вкладке. Во iframe страница оплаты не встраивается.
  • Для кнопки «покупатель вводит сумму» открывается страница /b/КОД с полем суммы.
  • Тильда: блок «HTML-код» (T123). WordPress: блок «Произвольный HTML».

Тильда — корзина и автоматическая отметка оплаты

Подключается через «Универсальную платёжную систему» Тильды: кабинет → «Кнопки оплаты» → карточка «Тильда» → «Подключить» — там логин, секрет и все значения для «Расширенных настроек». Покупатель оформляет корзину, переходит на страницу оплаты, а после оплаты шлюз отправляет Тильде подписанное уведомление, и заказ становится оплаченным.

  • API URL: https://paymeusd.com/tilda/pay, номер заказа Тильды становится order_id счёта (повторная отправка формы вернёт тот же счёт).
  • Подпись заказа — «Особые правила»: {{login}}:{{order_id}}:{{amount}}:{{currency}}:{{secret}}, SHA-256 (hex).
  • Подпись уведомления: {{login}}:{{order_id}}:{{amount}}:{{paid}}:{{secret}}, SHA-256; признак оплаты paid = 1, идентификатор транзакции — transaction_id (ID счёта), ответ об успехе — OK. Уведомление повторяется до суток, пока Тильда не ответит OK; журнал — в той же карточке кабинета.

Методы ниже вызывает виджет из браузера покупателя. Ключ API не нужен и не передаётся; ответы разрешены для любого сайта (CORS, без cookies). Действуют общие лимиты частоты запросов по IP.

Объект Button (публичный)

Что видит покупатель: данные для кнопки и страницы /b/КОД.

codestring
Код кнопки.
titlestring
Название — текст на странице и в описании счёта.
descriptionstring | null
Описание для покупателя.
amountstring | null
Фиксированная сумма; null — сумму вводит покупатель.
currencystring
Валюта суммы: фиат (USD, RUB…) или монета (USDT…).
custom_amountboolean
true — покупатель вводит сумму сам.
min_amountstring | null
Минимальная сумма (для custom_amount).
max_amountstring | null
Максимальная сумма (для custom_amount).
merchantobject
{ name } — название магазина.
urlstring
Страница кнопки /b/КОД — её можно отправлять как ссылку на оплату.
Пример
{
  "code": "7KQ2M9XHTA",
  "title": "Консультация 1 час",
  "description": "Созвон в Zoom",
  "amount": "25",
  "currency": "USD",
  "custom_amount": false,
  "min_amount": null,
  "max_amount": null,
  "merchant": {
    "name": "Shop"
  },
  "url": "https://paymeusd.com/b/7KQ2M9XHTA"
}

Данные кнопки

GET/api/public/buttons/{code}

Публичные данные кнопки — без ключа API. Выключенная или удалённая кнопка и кнопка неактивного магазина — 404.

Параметры пути

codestringобязательный
Код кнопки из кабинета (раздел «Кнопки оплаты»), например 7KQ2M9XHTA.

Ответ

Объект Button.

Ошибки

not_found

Запрос
curl "https://paymeusd.com/api/public/buttons/k3x9qa7m" \
  
const res = await fetch('https://paymeusd.com/api/public/buttons/k3x9qa7m', {
  method: 'GET',
  headers: {
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/api/public/buttons/k3x9qa7m');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
  ],
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.get(
    "https://paymeusd.com/api/public/buttons/k3x9qa7m",
    
)
res.raise_for_status()
data = res.json()
Ответ 200
{
  "code": "7KQ2M9XHTA",
  "title": "Консультация 1 час",
  "description": "Созвон в Zoom",
  "amount": "25",
  "currency": "USD",
  "custom_amount": false,
  "min_amount": null,
  "max_amount": null,
  "merchant": {
    "name": "Shop"
  },
  "url": "https://paymeusd.com/b/7KQ2M9XHTA"
}

Счёт по кнопке

POST/api/public/buttons/{code}/invoice

Создаёт новый счёт по кнопке (каждый вызов — новый счёт) и возвращает ссылку на страницу оплаты. Без ключа API; вызывается из браузера с любого сайта.

Параметры пути

codestringобязательный
Код кнопки из кабинета (раздел «Кнопки оплаты»), например 7KQ2M9XHTA.

Тело запроса

amountstring
Сумма для кнопки «покупатель вводит сумму» — обязательна для неё, в пределах min_amount…max_amount. Для фиксированной кнопки не учитывается.
emailstring
Email покупателя — попадёт в metadata.email счёта.
commentstring
Комментарий покупателя (до 500 символов) — в metadata.comment.
return_urlstring
Куда вернуть покупателя без оплаты. Принимается, только если совпадает с сайтом, откуда пришёл запрос (заголовок Origin); иначе — страница кнопки.
langstring
Язык страницы оплаты, например ru или en.

Ответ

JSON — пример справа.

Ошибки

not_found amount_required invalid_amount amount_too_small amount_too_large validation_error rate_limited

Запрос
curl -X POST "https://paymeusd.com/api/public/buttons/k3x9qa7m/invoice" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "[email protected]",
  "comment": "Без звонка"
}'
const res = await fetch('https://paymeusd.com/api/public/buttons/k3x9qa7m/invoice', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "email": "[email protected]",
    "comment": "Без звонка"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
<?php
$ch = curl_init('https://paymeusd.com/api/public/buttons/k3x9qa7m/invoice');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
      'email' => "[email protected]",
      'comment' => "Без звонка",
  ]),
]);
$data = json_decode(curl_exec($ch), true);
import os, requests

res = requests.post(
    "https://paymeusd.com/api/public/buttons/k3x9qa7m/invoice",
    
    json={
        "email": "[email protected]",
        "comment": "Без звонка"
    },
)
res.raise_for_status()
data = res.json()
Ответ 201
{
  "id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
  "payment_url": "https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"
}

Вебхуки

Когда меняется статус счёта, приходит платёж на постоянный адрес или завершается выплата, мы отправляем POST на ваш URL (из параметра url_callback или настроек кабинета).

POST /webhooks/crypto
Content-Type: application/json
X-Webhook-Id: 3f1c…            ← уникален для доставки, используйте для дедупликации
X-Webhook-Event: invoice.paid
X-Webhook-Timestamp: 1794560245
X-Webhook-Signature: 5d2a9c…   ← HMAC-SHA256

{ "event": "invoice.paid", "created_at": "2026-11-13T09:05:28.502Z", "data": { …объект Invoice… } }

События

СобытиеКогдаdata
invoice.confirmingПлатёж найден, ждём подтвержденийInvoice
invoice.partialПолучена часть суммыInvoice
invoice.paid, invoice.paid_overСчёт оплачен — выдавайте заказInvoice
invoice.underpaid, invoice.expired, invoice.cancelledСчёт закрыт без полной оплатыInvoice
payment.detected, payment.confirmed, payment.failedПлатёж на постоянный адрес, поздний или «не той» монетойPayment + order_id
payout.queued, payout.pending_approval, payout.completed, payout.failed, payout.rejectedИзменился статус выплатыPayout
refund.queued, refund.pending_approval, refund.completed, refund.failed, refund.rejectedИзменился статус возврата покупателюPayout с kind: "refund"
test.pingТестовая отправка из кабинета—

Проверка подписи

Подпись — hex(HMAC_SHA256(webhook_secret, timestamp + "." + сырое_тело)). Секрет — в кабинете в разделе «Интеграция». Проверяйте подпись по сырому телу запроса до разбора JSON и отклоняйте запросы старше 5 минут.

Проверка подписи
import crypto from 'node:crypto';
import express from 'express';

const app = express();
// важно: подпись проверяется по СЫРОМУ телу
app.post('/webhooks/crypto', express.raw({ type: 'application/json' }), (req, res) => {
  const ts = req.get('x-webhook-timestamp') ?? '';
  const sig = req.get('x-webhook-signature') ?? '';
  const expected = crypto.createHmac('sha256', process.env.WEBHOOK_SECRET)
    .update(`${ts}.${req.body}`).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  if (!fresh || sig.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const event = JSON.parse(req.body);
  if (event.event === 'invoice.paid' || event.event === 'invoice.paid_over') {
    // выдать заказ event.data.order_id (идемпотентно!)
  }
  res.sendStatus(200);
});
<?php
$body = file_get_contents('php://input');
$ts   = $_SERVER['HTTP_X_WEBHOOK_TIMESTAMP'] ?? '';
$sig  = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $ts . '.' . $body, getenv('WEBHOOK_SECRET'));

if (abs(time() - (int)$ts) > 300 || !hash_equals($expected, $sig)) {
    http_response_code(401);
    exit;
}
$event = json_decode($body, true);
if (in_array($event['event'], ['invoice.paid', 'invoice.paid_over'], true)) {
    // выдать заказ $event['data']['order_id'] (идемпотентно!)
}
http_response_code(200);
import hmac, hashlib, os, time, json
from flask import Flask, request, abort

app = Flask(__name__)

@app.post("/webhooks/crypto")
def webhook():
    body = request.get_data()  # сырое тело
    ts = request.headers.get("X-Webhook-Timestamp", "")
    sig = request.headers.get("X-Webhook-Signature", "")
    expected = hmac.new(os.environ["WEBHOOK_SECRET"].encode(),
                        ts.encode() + b"." + body, hashlib.sha256).hexdigest()
    if abs(time.time() - int(ts or 0)) > 300 or not hmac.compare_digest(expected, sig):
        abort(401)
    event = json.loads(body)
    if event["event"] in ("invoice.paid", "invoice.paid_over"):
        pass  # выдать заказ event["data"]["order_id"] (идемпотентно!)
    return "", 200

Повторы и требования

  • Ответьте кодом 2xx в течение 10 секунд — иначе доставка будет повторена через 1 мин, 5 мин, 15 мин, 1 ч, 3 ч, 6 ч, 12 ч и 24 ч.
  • Обработчик должен быть идемпотентным: одно событие может прийти несколько раз — сверяйте X-Webhook-Id или статус заказа.
  • Редиректы не выполняются — указывайте конечный URL.
  • Журнал доставок и кнопка повтора — в кабинете, раздел «Интеграция».

Страница оплаты

Покупатель открывает payment_url — отдельную страницу на нашем домене. На ней он выбирает монету и сеть (с подсказкой о комиссии и времени), видит сумму, адрес, QR-код и статус подтверждений. Страница работает на русском и английском, в светлой и тёмной теме, на телефоне.

  • Перенаправляйте покупателя на payment_url или открывайте в новой вкладке. Встраивание во iframe запрещено по соображениям безопасности.
  • asset при создании счёта пропускает шаг выбора монеты, allowed_assets ограничивает варианты.
  • После оплаты покупатель увидит кнопку возврата на url_success. Но выдавайте заказ только по вебхуку или запросу API — переход по ссылке не подтверждает оплату.
  • Со страницы оплаты покупатель может открыть счёт на оплату, а после оплаты — квитанцию и сохранить их в PDF (ссылки — в documents объекта счёта). Это платёжные документы сервиса, а не фискальные чеки.

Тестовый режим

Сервис может работать в тестовых сетях: Ethereum Sepolia, TRON Nile, Solana Devnet, BNB Smart Chain Testnet и других. Ключи тестового режима начинаются с sk_test_, а на странице оплаты видна метка TESTNET.

  • Тестовые монеты бесплатно выдают краны (faucet) соответствующих сетей.
  • Все методы API, вебхуки и выплаты работают так же, как в боевом режиме.
  • Переключение на боевой режим — замена ключа на sk_live_…, код менять не нужно.