{"openapi":"3.1.0","info":{"title":"Crypto Payments API","version":"1.0.0","description":"API приёма криптовалютных платежей: счета, постоянные адреса, платежи, выплаты."},"servers":[{"url":"https://paymeusd.com"}],"security":[{"bearer":[]}],"paths":{"/v1/invoices":{"post":{"operationId":"createInvoice","summary":"Создать счёт","description":"Создаёт счёт и возвращает ссылку на страницу оплаты. Сумму можно указать в фиате — она будет пересчитана в выбранную покупателем монету по текущему курсу.","tags":["Счета"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","currency","order_id"],"properties":{"amount":{"type":"string","description":"Сумма, например `\"49.90\"`."},"currency":{"type":"string","description":"Валюта суммы: `USD`, `EUR`, `RUB`, `UAH`, `KZT`, `GBP`, `TRY` или тикер монеты (`USDT`, `BTC`…)."},"order_id":{"type":"string","description":"Ваш уникальный номер заказа (до 128 символов). Обеспечивает идемпотентность."},"lifetime_minutes":{"type":"integer","description":"Срок оплаты: от 5 до 43200 минут (30 дней). По умолчанию — 60. У счёта дольше суток сумма в монете действует 60 минут после выбора монеты: если покупатель вернётся позже, сумма пересчитается по текущему курсу; платёж, найденный позже чем через 30 минут после этого срока, засчитывается по курсу на момент зачисления."},"asset":{"type":"string","description":"Сразу выбрать монету и сеть, например `tron:USDT` — покупатель увидит реквизиты без шага выбора."},"allowed_assets":{"type":"array","items":{"type":"string"},"description":"Ограничить варианты оплаты, например `[\"tron:USDT\",\"bsc:USDT\"]`."},"description":{"type":"string","description":"Описание для покупателя (до 500 символов)."},"url_callback":{"type":"string","description":"URL для вебхуков по этому счёту. По умолчанию — URL из кабинета."},"url_success":{"type":"string","description":"Кнопка «Вернуться в магазин» после оплаты."},"url_return":{"type":"string","description":"Кнопка возврата без оплаты."},"metadata":{"type":"object","description":"Произвольные данные — вернутся в ответах и вебхуках."},"region":{"type":"string","description":"Домены какого региона подставить в `payment_url`: `ru` — для покупателей из России (через сервер в РФ), `global` — для остальных (через Cloudflare). По умолчанию — как в настройке магазина «Где ваши покупатели»."},"lang":{"type":"string","description":"Язык страницы оплаты: `en`, `ru`, `uk`, `kk`, `uz`, `az`, `es`, `pt` (Бразилия), `fr`, `de`, `it`, `pl`, `tr`, `ar`, `fa`, `hi`, `id`, `vi`, `th`, `zh` (упрощённый), `ja`, `ko`. Можно с регионом (`pt-BR`). Неподдерживаемый язык игнорируется. Покупатель может сменить язык на странице."},"customer":{"type":"object","description":"Реквизиты покупателя для счёта на оплату и квитанции (все поля необязательны): `name` — контактное лицо (до 200 символов), `company` — компания (до 200), `tax_id` — налоговый номер: ИНН, VAT ID… (до 64), `address` — адрес (до 500), `email` — после оплаты на него придёт ссылка на квитанцию (один раз, на языке `lang`). Без `email` страница оплаты спросит его у покупателя до выбора способа оплаты и сохранит в `customer.email`."},"buyer_country":{"type":"string","description":"Страна клиента — код ISO 3166-1 из двух букв (`RU`, `KZ`…). Если вашему магазину подключены дополнительные способы оплаты по странам, покупатель увидит способы только этой страны — независимо от его IP и часового пояса."},"p2p_methods":{"type":"array","items":{"type":"string"},"description":"Какие дополнительные способы оплаты показать (если они подключены вашему магазину): id или коды способов. Не передано — все доступные для страны покупателя, `[]` — без них."},"p2p_currency":{"type":"string","description":"Дополнительные способы оплаты: `invoice` — только в валюте счёта, без пересчёта (счёт в долларах — оплата в долларах); `convert` — в валюте клиента по курсу (клиент из страны со своей валютой платит в ней). Не передано — как в настройках магазина (по умолчанию `convert`). Если в валюте счёта таких способов нет, действует `convert`."},"crypto":{"type":"boolean","description":"`false` — без оплаты криптовалютой: только дополнительные способы оплаты, если они подключены (иначе — ошибка `no_payment_methods`). По умолчанию — `true`."},"theme":{"type":"string","description":"Тема страницы оплаты: `light` или `dark`. По умолчанию — как в оформлении магазина (кабинет → «Оформление»)."}}},"example":{"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"}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"id":"6722fb9d-ed9e-4710-9f08-c9b63600b25a","order_id":"1001","amount":"49.9","currency":"EUR","amount_usd":"55.24","description":"Оплата заказа 1001","currency_is_fiat":true,"payment_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","url_success":"https://shop.example/thanks","url_return":null,"expires_at":"2026-11-13T10:04:05.253Z","created_at":"2026-11-13T09:04:05.253Z","metadata":{"user_id":42},"lang":null,"region":null,"payment_urls":{"ru":"https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","global":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"},"buyer_country":null,"p2p_methods":null,"p2p_currency":"convert","crypto_off":false,"theme":null,"customer":{"name":null,"company":"Acme GmbH","tax_id":"DE123456789","address":null,"email":"billing@acme.example"},"documents":{"invoice_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice","receipt_url":null},"status":"pending","is_final":false,"network":null,"network_name":null,"token_standard":null,"asset":null,"symbol":null,"pay_amount":null,"paid_amount":"0","pending_amount":"0","remaining_amount":null,"address":null,"memo":null,"payment_uri":null,"required_confirmations":null,"fee_level":null,"settle_sec":null,"rate_usd":null,"paid_at":null,"payments":[],"refunded_amount":"0","refunds":[]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listInvoices","summary":"Список счетов","description":"Счета от новых к старым. Удобно искать счёт по своему номеру заказа.","tags":["Счета"],"parameters":[{"name":"order_id","in":"query","required":false,"description":"Найти счёт по вашему номеру заказа.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Фильтр по статусу.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"От 1 до 100, по умолчанию 20.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"items":[{"id":"6722fb9d-ed9e-4710-9f08-c9b63600b25a","order_id":"1001","amount":"49.9","currency":"EUR","amount_usd":"55.24","description":"Оплата заказа 1001","currency_is_fiat":true,"payment_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","url_success":"https://shop.example/thanks","url_return":null,"expires_at":"2026-11-13T10:04:05.253Z","created_at":"2026-11-13T09:04:05.253Z","metadata":{"user_id":42},"lang":null,"region":null,"payment_urls":{"ru":"https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","global":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"},"buyer_country":null,"p2p_methods":null,"p2p_currency":"convert","crypto_off":false,"theme":null,"customer":{"name":null,"company":"Acme GmbH","tax_id":"DE123456789","address":null,"email":"billing@acme.example"},"documents":{"invoice_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice","receipt_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/receipt"},"status":"paid","is_final":true,"network":"tron","network_name":"TRON","token_standard":"TRC-20","asset":"tron:USDT","symbol":"USDT","pay_amount":"55.24","paid_amount":"55.24","pending_amount":"0","remaining_amount":"0","address":"TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat","memo":null,"payment_uri":"TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat","required_confirmations":19,"fee_level":"medium","settle_sec":57,"rate_usd":"1","paid_at":"2026-11-13T09:05:28.416Z","payments":[{"id":"82a1a806-9162-4a3f-9109-e927ed7d6206","network":"tron","network_name":"TRON","asset":"tron:USDT","currency":"USDT","amount":"55.24","tx_hash":"b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c","from":"TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5","confirmations":19,"required_confirmations":19,"status":"confirmed","kind":"invoice","fee":"0.5524","credited_amount":"54.6876","explorer_url":"https://tronscan.org/#/transaction/b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c","detected_at":"2026-11-13T09:04:31.112Z","confirmed_at":"2026-11-13T09:05:28.416Z"}],"refunded_amount":"0","refunds":[]}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/invoices/{id}":{"get":{"operationId":"getInvoice","summary":"Получить счёт","description":"Текущее состояние счёта со всеми платежами.","tags":["Счета"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID счёта.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"6722fb9d-ed9e-4710-9f08-c9b63600b25a","order_id":"1001","amount":"49.9","currency":"EUR","amount_usd":"55.24","description":"Оплата заказа 1001","currency_is_fiat":true,"payment_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","url_success":"https://shop.example/thanks","url_return":null,"expires_at":"2026-11-13T10:04:05.253Z","created_at":"2026-11-13T09:04:05.253Z","metadata":{"user_id":42},"lang":null,"region":null,"payment_urls":{"ru":"https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","global":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"},"buyer_country":null,"p2p_methods":null,"p2p_currency":"convert","crypto_off":false,"theme":null,"customer":{"name":null,"company":"Acme GmbH","tax_id":"DE123456789","address":null,"email":"billing@acme.example"},"documents":{"invoice_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice","receipt_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/receipt"},"status":"paid","is_final":true,"network":"tron","network_name":"TRON","token_standard":"TRC-20","asset":"tron:USDT","symbol":"USDT","pay_amount":"55.24","paid_amount":"55.24","pending_amount":"0","remaining_amount":"0","address":"TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat","memo":null,"payment_uri":"TTRfafDmUho6qSvPUxJ5c8aq7Rp121Ukat","required_confirmations":19,"fee_level":"medium","settle_sec":57,"rate_usd":"1","paid_at":"2026-11-13T09:05:28.416Z","payments":[{"id":"82a1a806-9162-4a3f-9109-e927ed7d6206","network":"tron","network_name":"TRON","asset":"tron:USDT","currency":"USDT","amount":"55.24","tx_hash":"b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c","from":"TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5","confirmations":19,"required_confirmations":19,"status":"confirmed","kind":"invoice","fee":"0.5524","credited_amount":"54.6876","explorer_url":"https://tronscan.org/#/transaction/b1f3c8a95e0d4a7c9e2f6b3d1a8c7e5f4b2d9a6c3e1f8b7a5d4c2e9f6b3a1d8c","detected_at":"2026-11-13T09:04:31.112Z","confirmed_at":"2026-11-13T09:05:28.416Z"}],"refunded_amount":"0","refunds":[]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/invoices/{id}/cancel":{"post":{"operationId":"cancelInvoice","summary":"Отменить счёт","description":"Отменяет счёт в статусе `pending`, по которому ещё не было платежей.","tags":["Счета"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID счёта.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"6722fb9d-ed9e-4710-9f08-c9b63600b25a","order_id":"1001","amount":"49.9","currency":"EUR","amount_usd":"55.24","description":"Оплата заказа 1001","currency_is_fiat":true,"payment_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","url_success":"https://shop.example/thanks","url_return":null,"expires_at":"2026-11-13T10:04:05.253Z","created_at":"2026-11-13T09:04:05.253Z","metadata":{"user_id":42},"lang":null,"region":null,"payment_urls":{"ru":"https://pay-shop.ru/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a","global":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"},"buyer_country":null,"p2p_methods":null,"p2p_currency":"convert","crypto_off":false,"theme":null,"customer":{"name":null,"company":"Acme GmbH","tax_id":"DE123456789","address":null,"email":"billing@acme.example"},"documents":{"invoice_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a/invoice","receipt_url":null},"status":"cancelled","is_final":true,"network":null,"network_name":null,"token_standard":null,"asset":null,"symbol":null,"pay_amount":null,"paid_amount":"0","pending_amount":"0","remaining_amount":null,"address":null,"memo":null,"payment_uri":null,"required_confirmations":null,"fee_level":null,"settle_sec":null,"rate_usd":null,"paid_at":null,"payments":[],"refunded_amount":"0","refunds":[]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/invoices/{id}/refund":{"post":{"operationId":"refundInvoice","summary":"Вернуть деньги покупателю","description":"Создаёт возврат по оплаченному счёту — выплату в той же монете и сети, в которой платил покупатель. Можно вернуть всё или часть; несколько частичных возвратов тоже можно, но в сумме не больше полученного. Сумма возврата и комиссия сети за отправку списываются с вашего баланса, комиссия сервиса за приём не возвращается. Дальше возврат идёт как обычная выплата (крупные — после проверки), статусы приходят вебхуками `refund.*`. Рекомендуем передавать заголовок `Idempotency-Key` (раздел «Идемпотентность»): тогда повтор запроса после сетевой ошибки не создаст второй возврат, даже без `order_id`.","tags":["Счета"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID счёта.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Адрес покупателя в сети счёта. Спросите его у покупателя: адрес отправителя в блокчейне часто принадлежит бирже, и деньги туда не дойдут."},"amount":{"type":"string","description":"Сумма в монете счёта. По умолчанию — всё, что ещё не возвращено."},"memo":{"type":"string","description":"Комментарий к переводу — нужен при возврате на биржу в TON."},"reason":{"type":"string","description":"Причина возврата — для вашей истории."},"order_id":{"type":"string","description":"Ваш идентификатор возврата. С ним повторный запрос вернёт тот же возврат."},"url_callback":{"type":"string","description":"URL для вебхуков по этому возврату."}}},"example":{"address":"TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5","reason":"Товар закончился"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"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}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/static-wallets":{"post":{"operationId":"createStaticWallet","summary":"Получить постоянный адрес","description":"Возвращает адрес пользователя в сети. Повторный вызов с тем же `order_id` и сетью вернёт тот же адрес.","tags":["Постоянные адреса"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["network","order_id"],"properties":{"network":{"type":"string","description":"ID сети: `tron`, `bsc`, `ethereum`, `solana`, `ton`…"},"order_id":{"type":"string","description":"Ваш идентификатор пользователя."},"url_callback":{"type":"string","description":"URL для вебхуков по этому адресу."}}},"example":{"network":"tron","order_id":"user-42"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"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"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payments":{"get":{"operationId":"listPayments","summary":"Список платежей","description":"Платежи от новых к старым. Кроме полей Payment содержат `invoice_id` и `static_wallet_id`.","tags":["Платежи"],"parameters":[{"name":"kind","in":"query","required":false,"description":"Фильтр: `invoice`, `static`, `unexpected`, `late`.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"От 1 до 100, по умолчанию 50.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/balances":{"get":{"operationId":"getBalances","summary":"Получить балансы","description":"Доступные для вывода суммы по каждой монете.","tags":["Балансы"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"items":[{"currency":"USDT","available":"1254.18"},{"currency":"BTC","available":"0.01832"}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts":{"post":{"operationId":"createPayout","summary":"Создать выплату","description":"Ставит выплату в очередь. Повтор с тем же `order_id` вернёт существующую выплату. Рекомендуем также передавать заголовок `Idempotency-Key` (раздел «Идемпотентность»): повтор после сетевой ошибки или таймаута вернёт тот же ответ и ничего не спишет повторно.","tags":["Выплаты"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["network","currency","address","amount","order_id"],"properties":{"network":{"type":"string","description":"ID сети, например `tron`."},"currency":{"type":"string","description":"Тикер монеты, например `USDT`."},"address":{"type":"string","description":"Адрес получателя в этой сети — формат проверяется."},"amount":{"type":"string","description":"Сумма, которую получит адресат (комиссия добавится сверху)."},"order_id":{"type":"string","description":"Ваш уникальный идентификатор выплаты."},"memo":{"type":"string","description":"Комментарий — обязателен при выводе на биржу в TON."},"url_callback":{"type":"string","description":"URL для вебхуков по этой выплате."}}},"example":{"network":"tron","currency":"USDT","address":"TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5","amount":"150","order_id":"withdraw-77"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"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}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listPayouts","summary":"Список выплат","description":"Выплаты от новых к старым.","tags":["Выплаты"],"parameters":[{"name":"order_id","in":"query","required":false,"description":"Найти выплату по вашему идентификатору.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Фильтр по статусу.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"От 1 до 100, по умолчанию 50.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts/batch":{"post":{"operationId":"createPayoutBatch","summary":"Массовая выплата","description":"До 500 выплат одним запросом — зарплаты, партнёрские, выигрыши. Сначала проверяется каждая строка и хватает ли баланса по каждой монете; создаются либо все выплаты, либо ни одной (`400 batch_invalid`, разбор строк в `details`). С `validate_only: true` — только проверка. Дальше каждая выплата живёт как обычная: сверх дневного лимита — после одобрения. Повтор с тем же `reference` вернёт тот же пакет; без `reference` защищает от дубля заголовок `Idempotency-Key` (рекомендуем передавать всегда).","tags":["Выплаты"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object"},"description":"Выплаты: `network`, `currency`, `address`, `amount`, по желанию `memo` и `order_id` (по умолчанию — `<reference>-<номер>`)."},"reference":{"type":"string","description":"Ваш идентификатор пакета для идемпотентности."},"validate_only":{"type":"boolean","description":"Только проверить, ничего не создавая: ответ `200 {valid, count, errors, rows, totals}` — разбор строк и итоги по монетам с балансом."},"url_callback":{"type":"string","description":"URL для вебхуков `payout.*` по выплатам пакета."}}},"example":{"reference":"salary-2026-11","items":[{"network":"tron","currency":"USDT","address":"TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5","amount":"250"},{"network":"bsc","currency":"USDT","address":"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed","amount":"180"}]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"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}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts/batch/{id}":{"get":{"operationId":"getPayoutBatch","summary":"Получить пакет выплат","description":"Итоги пакета и текущие статусы всех его выплат.","tags":["Выплаты"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID пакета.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts/{id}":{"get":{"operationId":"getPayout","summary":"Получить выплату","description":"Текущий статус выплаты и хеш транзакции.","tags":["Выплаты"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID выплаты.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/assets":{"get":{"operationId":"listAssets","summary":"Список активов","description":"Все активы, доступные сейчас для оплаты и вывода.","tags":["Монеты и сети"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/domains":{"get":{"operationId":"listDomains","security":[],"summary":"Актуальные домены","description":"Основной домен сервиса в каждом регионе: `ru` — для покупателей из России, `global` — для остальных. Если домен заблокируют, сервис переключится на резервный — этот метод всегда отдаёт текущий. Без API-ключа.","tags":["Монеты и сети"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"regions":{"ru":{"active":"https://pay-shop.ru"},"global":{"active":"https://paymeusd.com"}},"fallback":"https://paymeusd.com"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/status":{"get":{"operationId":"getStatus","security":[],"summary":"Статус сервиса","description":"Работает ли сервис прямо сейчас: API и страница оплаты, зачисление платежей, вебхуки, выплаты и каждая сеть. `level`: `operational`, `degraded` (задержки), `outage`, `maintenance`. Плюс открытые инциденты и плановые работы. То же для людей — страница `/status`, лента инцидентов — `/status/feed.atom`. Без API-ключа.","tags":["Монеты и сети"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/currencies":{"get":{"operationId":"listCurrencies","summary":"Валюты счёта","description":"В каких валютах можно указать сумму счёта (`currency` в `POST /v1/invoices`): фиат по курсу и монеты подключённых сетей. Для монет указано, в каких сетях их можно принять.","tags":["Монеты и сети"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"]}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/plans":{"post":{"operationId":"createPlan","summary":"Создать тариф","description":"Тариф задаёт сумму и период. Подписки оформляются на тариф.","tags":["Регулярные платежи"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","amount","currency","interval"],"properties":{"name":{"type":"string","description":"Название (до 120 символов)."},"amount":{"type":"string","description":"Сумма за период, например `\"29\"`."},"currency":{"type":"string","description":"Валюта: `USD`, `EUR`, `RUB`, `UAH`, `KZT`, `GBP`, `TRY` или тикер монеты (`USDT`…)."},"interval":{"type":"string","description":"`day`, `week`, `month` или `year`."},"interval_count":{"type":"integer","description":"Сколько единиц в периоде, по умолчанию 1. Не больше 365 дней, 260 недель, 60 месяцев, 5 лет."},"trial_days":{"type":"integer","description":"Пробный период, дней (0–365). По умолчанию 0."},"grace_days":{"type":"integer","description":"Льготный срок после окончания периода, дней (0–60). По умолчанию 3."},"allowed_assets":{"type":"array","items":{"type":"string"},"description":"Ограничить монеты для оплаты, например `[\"tron:USDT\",\"bsc:USDT\"]`."},"description":{"type":"string","description":"Описание для покупателя (до 500 символов)."}}},"example":{"name":"Pro","amount":"29","currency":"USD","interval":"month","trial_days":14,"description":"До 10 проектов и приоритетная поддержка"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"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"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listPlans","summary":"Список тарифов","description":"Тарифы от новых к старым, архивные — в конце.","tags":["Регулярные платежи"],"parameters":[{"name":"include_archived","in":"query","required":false,"description":"`true` — показать и архивные.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"От 1 до 100, по умолчанию 50.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/plans/{id}":{"get":{"operationId":"getPlan","summary":"Получить тариф","description":"Тариф по ID.","tags":["Регулярные платежи"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID тарифа.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/plans/{id}/archive":{"post":{"operationId":"archivePlan","summary":"Архивировать тариф","description":"Новые подписки на тариф оформить будет нельзя. Действующие подписки продолжаются на прежних условиях.","tags":["Регулярные платежи"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID тарифа.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/subscriptions":{"post":{"operationId":"createSubscription","summary":"Оформить подписку","description":"Создаёт подписку на тариф. Без пробного периода счёт за первый период выставляется сразу — ссылка на оплату в `current_invoice.payment_url`, покупатель получит её и письмом. Повтор с тем же `order_id` вернёт существующую подписку (ответ `200`).","tags":["Регулярные платежи"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plan_id"],"properties":{"plan_id":{"type":"string","description":"ID тарифа."},"customer":{"type":"object","description":"Покупатель: `email` — куда слать счета и напоминания, `name`, `reference` — ваш ID пользователя."},"order_id":{"type":"string","description":"Ваш уникальный идентификатор подписки (до 128 символов). Обеспечивает идемпотентность."},"locale":{"type":"string","description":"Язык писем и страницы подписки: `ru` (по умолчанию) или `en`."},"start_at":{"type":"string","description":"Начало подписки в будущем (ISO 8601), не позже чем через год. По умолчанию — сейчас."},"metadata":{"type":"object","description":"Произвольные данные — вернутся в ответах и вебхуках."}}},"example":{"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}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"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://paymeusd.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"},"customer_url":"https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe","metadata":{"user_id":42},"created_at":"2026-11-13T09:00:00.000Z"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listSubscriptions","summary":"Список подписок","description":"Подписки от новых к старым.","tags":["Регулярные платежи"],"parameters":[{"name":"status","in":"query","required":false,"description":"Фильтр по статусу.","schema":{"type":"string"}},{"name":"plan_id","in":"query","required":false,"description":"Подписки одного тарифа.","schema":{"type":"string"}},{"name":"order_id","in":"query","required":false,"description":"Найти по вашему идентификатору.","schema":{"type":"string"}},{"name":"customer_email","in":"query","required":false,"description":"Подписки покупателя по email.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"От 1 до 100, по умолчанию 20.","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Сколько пропустить — для постраничного просмотра.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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://paymeusd.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"},"customer_url":"https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe","metadata":{"user_id":42},"created_at":"2026-11-13T09:00:00.000Z"}]}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/subscriptions/{id}":{"get":{"operationId":"getSubscription","summary":"Получить подписку","description":"Текущее состояние подписки и счёт за следующий период.","tags":["Регулярные платежи"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID подписки.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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://paymeusd.com/pay/0e9f8a7b-6c5d-4e3f-8a1b-2c3d4e5f6a7b"},"customer_url":"https://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe","metadata":{"user_id":42},"created_at":"2026-11-13T09:00:00.000Z"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/subscriptions/{id}/cancel":{"post":{"operationId":"cancelSubscription","summary":"Отменить подписку","description":"Сразу (по умолчанию) или в конце оплаченного периода. Неоплаченный счёт за следующий период отменяется. Подписку без оплаченного периода (`pending`, `past_due`) отменяет сразу. Повтор ничего не меняет.","tags":["Регулярные платежи"],"parameters":[{"name":"id","in":"path","required":true,"description":"ID подписки.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"at_period_end":{"type":"boolean","description":"`true` — отменить продление: подписка действует до `current_period_end`, затем `cancelled`."}}},"example":{"at_period_end":true}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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://paymeusd.com/s/Xq3v9Lr2Tn8Wk5Pz1Hc7Jm4Ba6Ds0Fe","metadata":{"user_id":42},"created_at":"2026-11-13T09:00:00.000Z"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/buttons/{code}":{"get":{"operationId":"getButton","security":[],"summary":"Данные кнопки","description":"Публичные данные кнопки — без ключа API. Выключенная или удалённая кнопка и кнопка неактивного магазина — `404`.","tags":["Кнопки оплаты и виджет"],"parameters":[{"name":"code","in":"path","required":true,"description":"Код кнопки из кабинета (раздел «Кнопки оплаты»), например `7KQ2M9XHTA`.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"code":"7KQ2M9XHTA","title":"Консультация 1 час","description":"Созвон в Zoom","amount":"25","currency":"USD","custom_amount":false,"min_amount":null,"max_amount":null,"merchant":{"name":"Shop"},"url":"https://paymeusd.com/b/7KQ2M9XHTA"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/buttons/{code}/invoice":{"post":{"operationId":"createButtonInvoice","security":[],"summary":"Счёт по кнопке","description":"Создаёт новый счёт по кнопке (каждый вызов — новый счёт) и возвращает ссылку на страницу оплаты. Без ключа API; вызывается из браузера с любого сайта.","tags":["Кнопки оплаты и виджет"],"parameters":[{"name":"code","in":"path","required":true,"description":"Код кнопки из кабинета (раздел «Кнопки оплаты»), например `7KQ2M9XHTA`.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"string","description":"Сумма для кнопки «покупатель вводит сумму» — обязательна для неё, в пределах `min_amount`…`max_amount`. Для фиксированной кнопки не учитывается."},"email":{"type":"string","description":"Email покупателя — попадёт в `metadata.email` счёта."},"comment":{"type":"string","description":"Комментарий покупателя (до 500 символов) — в `metadata.comment`."},"return_url":{"type":"string","description":"Куда вернуть покупателя без оплаты. Принимается, только если совпадает с сайтом, откуда пришёл запрос (заголовок `Origin`); иначе — страница кнопки."},"lang":{"type":"string","description":"Язык страницы оплаты, например `ru` или `en`."}}},"example":{"email":"buyer@example.com","comment":"Без звонка"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"id":"6722fb9d-ed9e-4710-9f08-c9b63600b25a","payment_url":"https://paymeusd.com/pay/6722fb9d-ed9e-4710-9f08-c9b63600b25a"}}}},"default":{"description":"Ошибка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Секретный ключ sk_live_… или sk_test_…"}},"schemas":{"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}