Документация API
Принимайте оплату в USDT и другой криптовалюте через REST API: создавайте счета, выдавайте постоянные адреса, получайте подписанные вебхуки и выводите средства.
Введение
API позволяет создавать счета на оплату криптовалютой, выдавать постоянные адреса для пополнений, получать уведомления о платежах и выводить средства. Все запросы — HTTPS, тела запросов и ответов — JSON в кодировке UTF-8.
https://paymway.com- Суммы передаются и возвращаются строками (
"49.90"), чтобы не терять точность. - Даты — в формате ISO 8601, UTC.
- Активы обозначаются как
сеть:МОНЕТА:tron:USDT,bsc:USDT,bitcoin:BTC.
Быстрый старт
- Получите API-ключ. Зарегистрируйтесь и создайте ключ в кабинете: Интеграция → API-ключи.
- Создайте счёт запросом
POST /v1/invoicesи перенаправьте покупателя наpayment_url. - Примите вебхук
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 | Код | Когда |
|---|---|---|
| 400 | validation_error | Неверные параметры запроса |
| 400 | unsupported_currency, unknown_asset, asset_not_allowed | Валюта или актив не поддерживаются |
| 400 | invalid_address, amount_too_small, insufficient_balance | Ошибки выплаты |
| 401 | unauthorized | Нет ключа, ключ неверный или отозван, аккаунт не активен |
| 404 | not_found | Объект не найден или принадлежит другому аккаунту |
| 400 | invalid_idempotency_key | Заголовок Idempotency-Key пустой, длиннее 255 символов или не из печатных символов ASCII |
| 409 | order_exists | Такой order_id уже есть с другими параметрами |
| 409 | idempotency_in_progress | Запрос с этим Idempotency-Key ещё выполняется — повторите через несколько секунд |
| 422 | idempotency_key_mismatch | Этот Idempotency-Key уже использован с другим запросом — нужен новый ключ |
| 409 | invoice_locked | Счёт уже нельзя изменить или отменить |
| 409 | nothing_to_refund | По счёту нечего возвращать: платежей нет или всё уже возвращено |
| 400 | refund_too_large | Сумма возврата больше полученной по счёту |
| 400 | batch_invalid | Массовая выплата не создана: ошибки в строках или не хватает баланса — разбор в details |
| 403 | address_not_whitelisted, address_not_active_yet | Включён белый список адресов вывода: адреса нет в списке или он ещё не заработал (новые — через 24 ч) |
| 403 | refund_requires_cabinet | При включённом белом списке возвраты делаются только из кабинета |
| 429 | rate_limited | Слишком много запросов — повторите через указанное в сообщении время |
| 500 | internal_error | Сбой на стороне сервиса — повторите позже; если повторяется, напишите в поддержку |
| 503 | rate_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 | Платёж найден, ждём подтверждений сети |
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_finalbooleantrue— статус больше не изменится.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_offbooleantrue— оплата криптовалютой в этом счёте выключена (при создании передали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://paymway.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://paymway.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": "billing@acme.example"
},
"documents": {
"invoice_url": "https://paymway.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
"receipt_url": "https://paymway.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": []
}Создать счёт
/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. cryptobooleanfalse— без оплаты криптовалютой: только дополнительные способы оплаты, если они подключены (иначе — ошибка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://paymway.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": "billing@acme.example"
}
}'const res = await fetch('https://paymway.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": "billing@acme.example"
}
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);<?php
$ch = curl_init('https://paymway.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' => "billing@acme.example"],
]),
]);
$data = json_decode(curl_exec($ch), true);import os, requests
res = requests.post(
"https://paymway.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": "billing@acme.example"
}
},
)
res.raise_for_status()
data = res.json()
{
"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://paymway.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://paymway.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": "billing@acme.example"
},
"documents": {
"invoice_url": "https://paymway.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": []
}Получить счёт
/v1/invoices/{id}Текущее состояние счёта со всеми платежами.
Параметры пути
idstringобязательный- ID счёта.
Ответ
Объект Invoice.
Ошибки
not_found
curl "https://paymway.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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://paymway.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://paymway.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": "billing@acme.example"
},
"documents": {
"invoice_url": "https://paymway.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
"receipt_url": "https://paymway.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": []
}Список счетов
/v1/invoicesСчета от новых к старым. Удобно искать счёт по своему номеру заказа.
Параметры запроса
order_idstring- Найти счёт по вашему номеру заказа.
statusstring- Фильтр по статусу.
limitinteger- От 1 до 100, по умолчанию 20.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/invoices?order_id=1001" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/invoices?order_id=1001",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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://paymway.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://paymway.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": "billing@acme.example"
},
"documents": {
"invoice_url": "https://paymway.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice",
"receipt_url": "https://paymway.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": []
}
]
}Отменить счёт
/v1/invoices/{id}/cancelОтменяет счёт в статусе pending, по которому ещё не было платежей.
Параметры пути
idstringобязательный- ID счёта.
Ответ
Объект Invoice.
Ошибки
not_found invoice_locked
curl -X POST "https://paymway.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/invoices/6722fb9d-ed9e-4710-9f08-c9b63600b25a/cancel",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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://paymway.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://paymway.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": "billing@acme.example"
},
"documents": {
"invoice_url": "https://paymway.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": []
}Вернуть деньги покупателю
/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://paymway.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://paymway.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://paymway.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://paymway.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()
{
"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"
}Получить постоянный адрес
/v1/static-walletsВозвращает адрес пользователя в сети. Повторный вызов с тем же order_id и сетью вернёт тот же адрес.
Тело запроса
networkstringобязательный- ID сети:
tron,bsc,ethereum,solana,ton… order_idstringобязательный- Ваш идентификатор пользователя.
url_callbackstring- URL для вебхуков по этому адресу.
Ответ
Объект StaticWallet.
Ошибки
network_unavailable
curl -X POST "https://paymway.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://paymway.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://paymway.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://paymway.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()
{
"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- Сколько нужно для зачисления.
statusstringpending— ждёт подтверждений,confirmed— зачислен,failed— откатился или выпал из сети.kindstringinvoice— оплата счёта;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"
}Список платежей
/v1/paymentsПлатежи от новых к старым. Кроме полей Payment содержат invoice_id и static_wallet_id.
Параметры запроса
kindstring- Фильтр:
invoice,static,unexpected,late. limitinteger- От 1 до 100, по умолчанию 50.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/payments" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/payments",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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, полученный в разных сетях, суммируется. Вывести его можно в любой поддерживаемой сети.
Получить балансы
/v1/balancesДоступные для вывода суммы по каждой монете.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/balances" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/balances",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"items": [
{
"currency": "USDT",
"available": "1254.18"
},
{
"currency": "BTC",
"available": "0.01832"
}
]
}Выплаты
Выплата переводит средства с вашего баланса на внешний адрес. Сумма и комиссия списываются с баланса сразу при создании; если выплата будет отклонена или не пройдёт, деньги вернутся.
Небольшие выплаты отправляются автоматически, крупные — после ручной проверки. Комиссия и минимальная сумма для каждой сети — в GET /v1/assets.
Объект Payout
Вывод средств на внешний адрес.
idstring- ID выплаты.
kindstringpayout— вывод с баланса;refund— возврат покупателю по счёту.invoice_idstring | null- Для возврата — ID счёта.
batch_idstring | null- ID пакета, если выплата создана массовой выплатой.
reasonstring | null- Причина возврата, если указали.
order_idstring- Ваш идентификатор выплаты (идемпотентность).
statusstringpending_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
}Создать выплату
/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://paymway.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://paymway.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://paymway.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://paymway.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()
{
"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
}Массовая выплата
/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://paymway.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://paymway.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://paymway.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://paymway.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()
{
"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
}
]
}Получить пакет выплат
/v1/payouts/batch/{id}Итоги пакета и текущие статусы всех его выплат.
Параметры пути
idstringобязательный- ID пакета.
Ответ
Объект со списком items.
Ошибки
not_found
curl "https://paymway.com/v1/payouts/batch/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/payouts/batch/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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
}
]
}Получить выплату
/v1/payouts/{id}Текущий статус выплаты и хеш транзакции.
Параметры пути
idstringобязательный- ID выплаты.
Ответ
Объект Payout.
Ошибки
not_found
curl "https://paymway.com/v1/payouts/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/payouts/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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"
}Список выплат
/v1/payoutsВыплаты от новых к старым.
Параметры запроса
order_idstring- Найти выплату по вашему идентификатору.
statusstring- Фильтр по статусу.
limitinteger- От 1 до 100, по умолчанию 50.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/payouts" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/payouts",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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:BTC | Bitcoin | 8 | 2 | 20 мин | 0.00001 | 0.0002 |
ethereum:ETH | Ethereum | 18 | 12 | 2 мин | 0.00001 | 0.0005 |
ethereum:USDT | Ethereum ERC-20 | 6 | 12 | 2 мин | 0.01 | 5 |
ethereum:USDC | Ethereum ERC-20 | 6 | 12 | 2 мин | 0.01 | 5 |
bsc:BNB | BNB Smart Chain | 18 | 15 | 10 сек | 0.0001 | 0.0005 |
bsc:USDT | BNB Smart Chain BEP-20 | 18 | 15 | 10 сек | 0.01 | 0.5 |
bsc:USDC | BNB Smart Chain BEP-20 | 18 | 15 | 10 сек | 0.01 | 0.5 |
polygon:POL | Polygon | 18 | 32 | 1 мин | 0.01 | 0.5 |
polygon:USDT | Polygon ERC-20 | 6 | 32 | 1 мин | 0.01 | 0.5 |
polygon:USDC | Polygon ERC-20 | 6 | 32 | 1 мин | 0.01 | 0.5 |
arbitrum:ETH | Arbitrum One | 18 | 20 | 5 сек | 0.00001 | 0.0005 |
arbitrum:USDT | Arbitrum One ERC-20 | 6 | 20 | 5 сек | 0.01 | 0.5 |
arbitrum:USDC | Arbitrum One ERC-20 | 6 | 20 | 5 сек | 0.01 | 0.5 |
optimism:ETH | Optimism | 18 | 20 | 40 сек | 0.00001 | 0.0005 |
optimism:USDT | Optimism ERC-20 | 6 | 20 | 40 сек | 0.01 | 0.5 |
optimism:USDC | Optimism ERC-20 | 6 | 20 | 40 сек | 0.01 | 0.5 |
base:ETH | Base | 18 | 20 | 40 сек | 0.00001 | 0.0005 |
base:USDC | Base ERC-20 | 6 | 20 | 40 сек | 0.01 | 0.5 |
avalanche:AVAX | Avalanche C-Chain | 18 | 3 | 5 сек | 0.001 | 0.02 |
avalanche:USDT | Avalanche C-Chain ERC-20 | 6 | 3 | 5 сек | 0.01 | 0.5 |
avalanche:USDC | Avalanche C-Chain ERC-20 | 6 | 3 | 5 сек | 0.01 | 0.5 |
plasma:XPL | Plasma | 18 | 10 | 10 сек | 0.01 | 0.5 |
plasma:USDT | Plasma ERC-20 | 6 | 10 | 10 сек | 0.01 | 0.5 |
kaia:KAIA | Kaia | 18 | 3 | 5 сек | 0.1 | 1 |
kaia:USDT | Kaia ERC-20 | 6 | 3 | 5 сек | 0.01 | 0.5 |
celo:CELO | Celo | 18 | 10 | 10 сек | 0.1 | 0.5 |
celo:USDT | Celo ERC-20 | 6 | 10 | 10 сек | 0.01 | 0.5 |
celo:USDC | Celo ERC-20 | 6 | 10 | 10 сек | 0.01 | 0.5 |
kava:KAVA | Kava | 18 | 3 | 20 сек | 0.1 | 0.5 |
kava:USDT | Kava ERC-20 | 6 | 3 | 20 сек | 0.01 | 0.5 |
mantle:MNT | Mantle | 18 | 20 | 40 сек | 0.1 | 0.5 |
mantle:USDT | Mantle ERC-20 | 6 | 20 | 40 сек | 0.01 | 0.5 |
tron:TRX | TRON | 6 | 19 | 55 сек | 1 | 1 |
tron:USDT | TRON TRC-20 | 6 | 19 | 55 сек | 0.01 | 2 |
solana:SOL | Solana | 9 | 32 | 15 сек | 0.0001 | 0.005 |
solana:USDT | Solana SPL | 6 | 32 | 15 сек | 0.01 | 1 |
solana:USDC | Solana SPL | 6 | 32 | 15 сек | 0.01 | 1 |
ton:TON | TON | 9 | 1 | 5 сек | 0.01 | 0.05 |
ton:USDT | TON | 6 | 1 | 5 сек | 0.01 | 1 |
Серые строки — монеты, нужные только для газа: принимаются как «неожиданный» платёж, но не предлагаются покупателю.
Объект 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"
}Список активов
/v1/assetsВсе активы, доступные сейчас для оплаты и вывода.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/assets" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/assets",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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"
}
]
}Актуальные домены
/v1/domainsОсновной домен сервиса в каждом регионе: ru — для покупателей из России, global — для остальных. Если домен заблокируют, сервис переключится на резервный — этот метод всегда отдаёт текущий. Без API-ключа.
Ответ
JSON — пример справа.
curl "https://paymway.com/v1/domains" \
const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/domains",
)
res.raise_for_status()
data = res.json()
{
"regions": {
"ru": {
"active": "https://pay-shop.ru"
},
"global": {
"active": "https://paymway.com"
}
},
"fallback": "https://paymway.com"
}Статус сервиса
/v1/statusРаботает ли сервис прямо сейчас: API и страница оплаты, зачисление платежей, вебхуки, выплаты и каждая сеть. level: operational, degraded (задержки), outage, maintenance. Плюс открытые инциденты и плановые работы. То же для людей — страница /status, лента инцидентов — /status/feed.atom. Без API-ключа.
Ответ
JSON — пример справа.
curl "https://paymway.com/v1/status" \
const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/status",
)
res.raise_for_status()
data = res.json()
{
"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"
}Валюты счёта
/v1/currenciesВ каких валютах можно указать сумму счёта (currency в POST /v1/invoices): фиат по курсу и монеты подключённых сетей. Для монет указано, в каких сетях их можно принять.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/currencies" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/currencies",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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, сервисы, абонементы. Криптовалюту нельзя списать автоматически, поэтому подписка — это расписание счетов, напоминания покупателю и статусы.
- Создайте тариф —
POST /v1/plans: сумма и период, по желанию пробный период. - Оформите подписку —
POST /v1/subscriptionsс email покупателя. Без пробного периода счёт за первый период выставляется сразу: отправьте покупателя наcurrent_invoice.payment_url. - Дальше всё само: заранее (по умолчанию за 3 дня) до конца оплаченного периода покупатель получает счёт на следующий период (письмом и в Telegram), за день — напоминание. Оплата продлевает подписку от конца текущего периода, вам приходит вебхук
subscription.renewed.
| Статус | Значение |
|---|---|
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— любыми. archivedbooleantrue— тариф в архиве: новые подписки нельзя, действующие продолжаются.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).
statusstringpending,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_endbooleantrue— продление отменено: новых счетов не будет, в конце периода статус станет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": "anna@example.com",
"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://paymway.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
},
"customer_url": "https://paymway.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
"metadata": {
"user_id": 42
},
"created_at": "2026-11-13T09:00:00.000Z"
}Создать тариф
/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://paymway.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://paymway.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://paymway.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://paymway.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()
{
"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"
}Список тарифов
/v1/plansТарифы от новых к старым, архивные — в конце.
Параметры запроса
include_archivedstringtrue— показать и архивные.limitinteger- От 1 до 100, по умолчанию 50.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/plans" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/plans",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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"
}
]
}Получить тариф
/v1/plans/{id}Тариф по ID.
Параметры пути
idstringобязательный- ID тарифа.
Ответ
Объект Plan.
Ошибки
not_found
curl "https://paymway.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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"
}Архивировать тариф
/v1/plans/{id}/archiveНовые подписки на тариф оформить будет нельзя. Действующие подписки продолжаются на прежних условиях.
Параметры пути
idstringобязательный- ID тарифа.
Ответ
Объект Plan.
Ошибки
not_found
curl -X POST "https://paymway.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a/archive" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/plans/6722fb9d-ed9e-4710-9f08-c9b63600b25a/archive",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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"
}Оформить подписку
/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://paymway.com/v1/subscriptions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
"customer": {
"email": "anna@example.com",
"name": "Анна",
"reference": "user-42"
},
"order_id": "user-42-pro",
"metadata": {
"user_id": 42
}
}'const res = await fetch('https://paymway.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": "anna@example.com",
"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://paymway.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' => "anna@example.com", '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://paymway.com/v1/subscriptions",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
json={
"plan_id": "5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f",
"customer": {
"email": "anna@example.com",
"name": "Анна",
"reference": "user-42"
},
"order_id": "user-42-pro",
"metadata": {
"user_id": 42
}
},
)
res.raise_for_status()
data = res.json()
{
"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": "anna@example.com",
"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://paymway.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
},
"customer_url": "https://paymway.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
"metadata": {
"user_id": 42
},
"created_at": "2026-11-13T09:00:00.000Z"
}Список подписок
/v1/subscriptionsПодписки от новых к старым.
Параметры запроса
statusstring- Фильтр по статусу.
plan_idstring- Подписки одного тарифа.
order_idstring- Найти по вашему идентификатору.
customer_emailstring- Подписки покупателя по email.
limitinteger- От 1 до 100, по умолчанию 20.
offsetinteger- Сколько пропустить — для постраничного просмотра.
Ответ
Объект со списком items.
curl "https://paymway.com/v1/subscriptions?customer_email=anna%40example.com" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/subscriptions?customer_email=anna%40example.com",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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": "anna@example.com",
"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://paymway.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
},
"customer_url": "https://paymway.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
"metadata": {
"user_id": 42
},
"created_at": "2026-11-13T09:00:00.000Z"
}
]
}Получить подписку
/v1/subscriptions/{id}Текущее состояние подписки и счёт за следующий период.
Параметры пути
idstringобязательный- ID подписки.
Ответ
Объект Subscription.
Ошибки
not_found
curl "https://paymway.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a" \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://paymway.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://paymway.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://paymway.com/v1/subscriptions/6722fb9d-ed9e-4710-9f08-c9b63600b25a",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
res.raise_for_status()
data = res.json()
{
"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": "anna@example.com",
"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://paymway.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"
},
"customer_url": "https://paymway.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe",
"metadata": {
"user_id": 42
},
"created_at": "2026-11-13T09:00:00.000Z"
}Отменить подписку
/v1/subscriptions/{id}/cancelСразу (по умолчанию) или в конце оплаченного периода. Неоплаченный счёт за следующий период отменяется. Подписку без оплаченного периода (pending, past_due) отменяет сразу. Повтор ничего не меняет.
Параметры пути
idstringобязательный- ID подписки.
Тело запроса
at_period_endbooleantrue— отменить продление: подписка действует доcurrent_period_end, затемcancelled.
Ответ
Объект Subscription.
Ошибки
not_found
curl -X POST "https://paymway.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://paymway.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://paymway.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://paymway.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()
{
"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": "anna@example.com",
"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://paymway.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— сам инвойс (строка BOLT11lnbc…, 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 вида
name@wallet.example— удобнее всего: шлюз сам запросит у кошелька получателя инвойс на нужную сумму (LNURL-pay) и проверит его. - BOLT11-инвойс получателя. Сумма в инвойсе должна точно совпадать с
amount; инвойс без суммы оплачивается наamount. Инвойс одноразовый: оплатить его второй раз нельзя, а у просроченного выплата не пройдёт.
Если инвойс не подходит (другая сумма, истёк, кошелёк получателя не ответил) или платёж не нашёл маршрут, выплата получает статус failed
с причиной в error, а сумма и комиссия возвращаются на баланс. tx_hash выплаты — payment hash.
Комиссия за вывод — фиксированная, см. payout_fee в GET /v1/assets; комиссию маршрута платит шлюз.
Кнопки оплаты и виджет
Кнопка оплаты — как Payment Link: создайте её в кабинете (Кнопки оплаты) и получите ссылку https://paymway.com/b/КОД для соцсетей и мессенджеров и код кнопки для любого сайта. Сумма — фиксированная или её вводит покупатель (донаты, пополнения, оплата по счёту) с минимумом и максимумом. Каждое нажатие создаёт обычный счёт с order_id вида btn-КОД-… — оплату видно в разделе «Счета», а на ваш URL приходят те же вебхуки invoice.*. Email и комментарий покупателя — в metadata счёта: {"button": "КОД", "email": "…", "comment": "…"}.
Кнопка на сайт — одна строка
<script src="https://paymway.com/widget.js" data-button="КОД" async></script>
Кнопка появится там, где стоит тег. Несколько кнопок на странице — разметка <div data-cp-button="КОД"></div> и один тег <script src="https://paymway.com/widget.js" async></script> в конце страницы (кнопки, добавленные скриптами сайта позже, тоже появятся).
| Атрибут | Значение |
|---|---|
data-theme | light (по умолчанию) или dark — для тёмного сайта |
data-lang | ru или en; по умолчанию — язык страницы |
data-label | Свой текст кнопки, например «Поддержать проект» |
- Кнопка рисуется в Shadow DOM: стили сайта её не ломают, а её стили не задевают сайт. Работает при строгом CSP сайта, если разрешены
script-srcиconnect-srcдляhttps://paymway.com. - По нажатию создаётся счёт, и страница оплаты открывается в новом окне на компьютере и в новой вкладке на телефоне. Если всплывающие окна запрещены — в той же вкладке. Во
iframeстраница оплаты не встраивается. - Для кнопки «покупатель вводит сумму» открывается страница
/b/КОДс полем суммы. - Тильда: блок «HTML-код» (T123). WordPress: блок «Произвольный HTML».
Тильда — корзина и автоматическая отметка оплаты
Подключается через «Универсальную платёжную систему» Тильды: кабинет → «Кнопки оплаты» → карточка «Тильда» → «Подключить» — там логин, секрет и все значения для «Расширенных настроек». Покупатель оформляет корзину, переходит на страницу оплаты, а после оплаты шлюз отправляет Тильде подписанное уведомление, и заказ становится оплаченным.
- API URL:
https://paymway.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_amountbooleantrue— покупатель вводит сумму сам.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://paymway.com/b/7KQ2M9XHTA"
}Данные кнопки
/api/public/buttons/{code}Публичные данные кнопки — без ключа API. Выключенная или удалённая кнопка и кнопка неактивного магазина — 404.
Параметры пути
codestringобязательный- Код кнопки из кабинета (раздел «Кнопки оплаты»), например
7KQ2M9XHTA.
Ответ
Объект Button.
Ошибки
not_found
curl "https://paymway.com/api/public/buttons/k3x9qa7m" \
const res = await fetch('https://paymway.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://paymway.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://paymway.com/api/public/buttons/k3x9qa7m",
)
res.raise_for_status()
data = res.json()
{
"code": "7KQ2M9XHTA",
"title": "Консультация 1 час",
"description": "Созвон в Zoom",
"amount": "25",
"currency": "USD",
"custom_amount": false,
"min_amount": null,
"max_amount": null,
"merchant": {
"name": "Shop"
},
"url": "https://paymway.com/b/7KQ2M9XHTA"
}Счёт по кнопке
/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://paymway.com/api/public/buttons/k3x9qa7m/invoice" \
-H "Content-Type: application/json" \
-d '{
"email": "buyer@example.com",
"comment": "Без звонка"
}'const res = await fetch('https://paymway.com/api/public/buttons/k3x9qa7m/invoice', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
"email": "buyer@example.com",
"comment": "Без звонка"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);<?php
$ch = curl_init('https://paymway.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' => "buyer@example.com",
'comment' => "Без звонка",
]),
]);
$data = json_decode(curl_exec($ch), true);import os, requests
res = requests.post(
"https://paymway.com/api/public/buttons/k3x9qa7m/invoice",
json={
"email": "buyer@example.com",
"comment": "Без звонка"
},
)
res.raise_for_status()
data = res.json()
{
"id": "6722fb9d-ed9e-4710-9f08-c9b63600b25a",
"payment_url": "https://paymway.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_…, код менять не нужно.