{"openapi":"3.1.0","info":{"title":"Crypto Payments API","version":"1.0.0","description":"Crypto payment acceptance API: invoices, static addresses, payments, payouts. Error messages are in Russian by default; send `Accept-Language: en` to get them in English."},"servers":[{"url":"https://paymeusd.com"}],"security":[{"bearer":[]}],"paths":{"/v1/invoices":{"post":{"operationId":"createInvoice","summary":"Create an invoice","description":"Creates an invoice and returns a payment page link. The amount can be set in fiat — it is converted into the coin the customer selects at the current rate.","tags":["Invoices"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","currency","order_id"],"properties":{"amount":{"type":"string","description":"Amount, e.g. `\"49.90\"`."},"currency":{"type":"string","description":"Currency of the amount: `USD`, `EUR`, `RUB`, `UAH`, `KZT`, `GBP`, `TRY` or a coin ticker (`USDT`, `BTC`…)."},"order_id":{"type":"string","description":"Your unique order number (up to 128 characters). Ensures idempotency."},"lifetime_minutes":{"type":"integer","description":"Payment window: 5 to 43200 minutes (30 days). Default: 60. For invoices longer than a day the coin amount is valid for 60 minutes after the coin is chosen; if the customer comes back later it is re-quoted at the current rate, and a payment detected more than 30 minutes after that window is counted at the rate at the time it is credited."},"asset":{"type":"string","description":"Preselect the coin and network, e.g. `tron:USDT` — the customer sees the payment details without the selection step."},"allowed_assets":{"type":"array","items":{"type":"string"},"description":"Restrict the payment options, e.g. `[\"tron:USDT\",\"bsc:USDT\"]`."},"description":{"type":"string","description":"Description for the customer (up to 500 characters)."},"url_callback":{"type":"string","description":"Webhook URL for this invoice. Defaults to the URL set in the dashboard."},"url_success":{"type":"string","description":"“Back to store” button after payment."},"url_return":{"type":"string","description":"Return button for customers who leave without paying."},"metadata":{"type":"object","description":"Arbitrary data — returned in responses and webhooks."},"region":{"type":"string","description":"Which region’s domain to use in `payment_url`: `ru` — for customers in Russia (via a server in Russia), `global` — for everyone else (via Cloudflare). Defaults to the store setting “Where are your customers”."},"lang":{"type":"string","description":"Payment page language: `en`, `ru`, `uk`, `kk`, `uz`, `az`, `es`, `pt` (Brazil), `fr`, `de`, `it`, `pl`, `tr`, `ar`, `fa`, `hi`, `id`, `vi`, `th`, `zh` (Simplified), `ja`, `ko`. A region suffix is allowed (`pt-BR`). Unsupported languages are ignored. The customer can switch the language on the page."},"customer":{"type":"object","description":"Buyer details for the invoice and payment receipt (all fields optional): `name` — contact person (up to 200 characters), `company` — company (up to 200), `tax_id` — tax ID: VAT ID, EIN… (up to 64), `address` — address (up to 500), `email` — a link to the receipt is sent there after payment (once, in the `lang` language). Without `email`, the payment page asks the buyer for it before they choose a payment method and saves it to `customer.email`."},"buyer_country":{"type":"string","description":"Client country — a two-letter ISO 3166-1 code (`RU`, `KZ`…). If additional payment methods by country are enabled for your store, the customer sees only this country’s methods — regardless of their IP and time zone."},"p2p_methods":{"type":"array","items":{"type":"string"},"description":"Which additional payment methods to show (if enabled for your store): method IDs or codes. Omitted — all available for the customer’s country, `[]` — none."},"p2p_currency":{"type":"string","description":"Additional payment methods: `invoice` — only in the invoice currency, without conversion (a USD invoice is paid in USD); `convert` — in the customer’s currency at the rate (a customer from a country with its own currency pays in it). Omitted — as in the store settings (`convert` by default). If there are no such methods in the invoice currency, `convert` applies."},"crypto":{"type":"boolean","description":"`false` — no crypto payment: only the additional payment methods, if enabled (otherwise the `no_payment_methods` error). Default: `true`."},"theme":{"type":"string","description":"Payment page theme: `light` or `dark`. Defaults to the store branding (dashboard → “Branding”)."}}},"example":{"amount":"49.90","currency":"EUR","order_id":"1001","description":"Payment for order 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":"Payment for order 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listInvoices","summary":"List invoices","description":"Invoices, newest first. Handy for looking up an invoice by your order number.","tags":["Invoices"],"parameters":[{"name":"order_id","in":"query","required":false,"description":"Find an invoice by your order number.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Filter by status.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 100, default 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":"Payment for order 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/invoices/{id}":{"get":{"operationId":"getInvoice","summary":"Retrieve an invoice","description":"Current state of the invoice with all its payments.","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"description":"Invoice 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":"Payment for order 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/invoices/{id}/cancel":{"post":{"operationId":"cancelInvoice","summary":"Cancel an invoice","description":"Cancels a `pending` invoice that has not received any payments yet.","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"description":"Invoice 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":"Payment for order 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/invoices/{id}/refund":{"post":{"operationId":"refundInvoice","summary":"Refund the customer","description":"Creates a refund for a paid invoice — a payout in the same coin and network the customer paid with. You can refund the full amount or part of it; several partial refunds are allowed as long as their total does not exceed the amount received. The refund amount and the network fee for sending it are debited from your balance; the service fee for receiving the payment is not refunded. From then on the refund is processed like a regular payout (large ones after review), and status updates arrive as `refund.*` webhooks. We recommend sending the `Idempotency-Key` header (see “Idempotency”): then retrying the request after a network error does not create a second refund, even without `order_id`.","tags":["Invoices"],"parameters":[{"name":"id","in":"path","required":true,"description":"Invoice ID.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Customer address on the invoice network. Ask the customer for it: the sender address on the blockchain often belongs to an exchange, and funds sent there will not reach the customer."},"amount":{"type":"string","description":"Amount in the invoice coin. Defaults to everything not yet refunded."},"memo":{"type":"string","description":"Transfer comment — needed when refunding to an exchange on TON."},"reason":{"type":"string","description":"Refund reason — for your records."},"order_id":{"type":"string","description":"Your refund ID. Repeating the request with it returns the same refund."},"url_callback":{"type":"string","description":"Webhook URL for this refund."}}},"example":{"address":"TPyjyZfsYaXStgz2NmAraF1uZcMtkgNan5","reason":"Out of stock"}}}},"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":"Out of stock","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/static-wallets":{"post":{"operationId":"createStaticWallet","summary":"Get a static address","description":"Returns the user’s address on the network. Calling again with the same `order_id` and network returns the same address.","tags":["Static addresses"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["network","order_id"],"properties":{"network":{"type":"string","description":"Network ID: `tron`, `bsc`, `ethereum`, `solana`, `ton`…"},"order_id":{"type":"string","description":"Your user ID."},"url_callback":{"type":"string","description":"Webhook URL for this address."}}},"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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payments":{"get":{"operationId":"listPayments","summary":"List payments","description":"Payments, newest first. In addition to the Payment fields, each item contains `invoice_id` and `static_wallet_id`.","tags":["Payments"],"parameters":[{"name":"kind","in":"query","required":false,"description":"Filter: `invoice`, `static`, `unexpected`, `late`.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 100, default 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/balances":{"get":{"operationId":"getBalances","summary":"Get balances","description":"Amounts available for withdrawal, per coin.","tags":["Balances"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"items":[{"currency":"USDT","available":"1254.18"},{"currency":"BTC","available":"0.01832"}]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts":{"post":{"operationId":"createPayout","summary":"Create a payout","description":"Queues a payout. Repeating with the same `order_id` returns the existing payout. We also recommend sending the `Idempotency-Key` header (see “Idempotency”): a retry after a network error or a timeout returns the same response and debits nothing again.","tags":["Payouts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["network","currency","address","amount","order_id"],"properties":{"network":{"type":"string","description":"Network ID, e.g. `tron`."},"currency":{"type":"string","description":"Coin ticker, e.g. `USDT`."},"address":{"type":"string","description":"Recipient address on this network — the format is validated."},"amount":{"type":"string","description":"Amount the recipient receives (the fee is added on top)."},"order_id":{"type":"string","description":"Your unique payout ID."},"memo":{"type":"string","description":"Comment — required when withdrawing to an exchange on TON."},"url_callback":{"type":"string","description":"Webhook URL for this payout."}}},"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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listPayouts","summary":"List payouts","description":"Payouts, newest first.","tags":["Payouts"],"parameters":[{"name":"order_id","in":"query","required":false,"description":"Find a payout by your ID.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Filter by status.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 100, default 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts/batch":{"post":{"operationId":"createPayoutBatch","summary":"Batch payout","description":"Up to 500 payouts in one request — salaries, affiliate payouts, winnings. Every row is validated first, and the balance is checked for each coin; either all payouts are created or none (`400 batch_invalid`, per-row results in `details`). With `validate_only: true` the request only validates. After that, each payout behaves like a regular one: above the daily limit it waits for approval. Repeating with the same `reference` returns the same batch; without `reference`, the `Idempotency-Key` header protects against duplicates (we recommend always sending it).","tags":["Payouts"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object"},"description":"Payouts: `network`, `currency`, `address`, `amount`, optionally `memo` and `order_id` (defaults to `<reference>-<number>`)."},"reference":{"type":"string","description":"Your batch ID for idempotency."},"validate_only":{"type":"boolean","description":"Validate only, without creating anything: the response is `200 {valid, count, errors, rows, totals}` — per-row results and per-coin totals against your balance."},"url_callback":{"type":"string","description":"Webhook URL for the `payout.*` events of the batch payouts."}}},"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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts/batch/{id}":{"get":{"operationId":"getPayoutBatch","summary":"Retrieve a payout batch","description":"Batch totals and the current status of every payout in it.","tags":["Payouts"],"parameters":[{"name":"id","in":"path","required":true,"description":"Batch 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/payouts/{id}":{"get":{"operationId":"getPayout","summary":"Retrieve a payout","description":"Current payout status and transaction hash.","tags":["Payouts"],"parameters":[{"name":"id","in":"path","required":true,"description":"Payout 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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/assets":{"get":{"operationId":"listAssets","summary":"List assets","description":"All assets currently available for payments and withdrawals.","tags":["Coins and networks"],"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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/domains":{"get":{"operationId":"listDomains","security":[],"summary":"Current domains","description":"The service’s primary domain in each region: `ru` — for customers in Russia, `global` — for everyone else. If a domain gets blocked, the service switches to a backup one — this method always returns the current domain. No API key required.","tags":["Coins and networks"],"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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/status":{"get":{"operationId":"getStatus","security":[],"summary":"Service status","description":"Whether the service is working right now: the API and payment page, payment crediting, webhooks, payouts and each network. `level`: `operational`, `degraded` (delays), `outage`, `maintenance`. Also lists open incidents and scheduled maintenance. Text fields (`text`, `name`, `level_text`, `status_text`) are for display — in Russian by default, in English with `Accept-Language: en`; base your logic on `level` and `id`. The human-readable version is the `/status` page, the incident feed is `/status/feed.atom`. No API key required.","tags":["Coins and networks"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"status":{"level":"operational","text":"All systems operational"},"components":[{"id":"api","group":"service","name":"API and payment page","level":"operational","level_text":"Operational"},{"id":"net:tron","group":"networks","name":"TRON","level":"operational","level_text":"Operational"}],"incidents":{"active":[],"scheduled":[],"recent":[]},"updated_at":"2026-11-13T09:04:05.000Z"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/currencies":{"get":{"operationId":"listCurrencies","summary":"Invoice currencies","description":"Currencies you can set the invoice amount in (`currency` in `POST /v1/invoices`): fiat at the current rate and the coins of connected networks. For coins, the networks they can be received on are listed. Use `code` in requests; `name` is a display name (in English with `Accept-Language: en`).","tags":["Coins and networks"],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"items":[{"code":"USD","type":"fiat","name":"US Dollar","rate_usd":"1","networks":[]},{"code":"EUR","type":"fiat","name":"Euro","rate_usd":"1.1","networks":[]},{"code":"USDT","type":"crypto","name":"Tether USD","rate_usd":"1","networks":["tron","bsc","ethereum","solana","ton"]}]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/plans":{"post":{"operationId":"createPlan","summary":"Create a plan","description":"A plan defines the amount and the billing period. Subscriptions are created for a plan.","tags":["Recurring payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","amount","currency","interval"],"properties":{"name":{"type":"string","description":"Name (up to 120 characters)."},"amount":{"type":"string","description":"Amount per period, e.g. `\"29\"`."},"currency":{"type":"string","description":"Currency: `USD`, `EUR`, `RUB`, `UAH`, `KZT`, `GBP`, `TRY` or a coin ticker (`USDT`…)."},"interval":{"type":"string","description":"`day`, `week`, `month` or `year`."},"interval_count":{"type":"integer","description":"Units per period, default 1. At most 365 days, 260 weeks, 60 months, 5 years."},"trial_days":{"type":"integer","description":"Trial period, days (0–365). Default 0."},"grace_days":{"type":"integer","description":"Grace period after the period ends, days (0–60). Default 3."},"allowed_assets":{"type":"array","items":{"type":"string"},"description":"Restrict the payment coins, e.g. `[\"tron:USDT\",\"bsc:USDT\"]`."},"description":{"type":"string","description":"Description for the customer (up to 500 characters)."}}},"example":{"name":"Pro","amount":"29","currency":"USD","interval":"month","trial_days":14,"description":"Up to 10 projects and priority support"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"example":{"id":"5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f","name":"Pro","description":"Up to 10 projects and priority support","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listPlans","summary":"List plans","description":"Plans, newest first; archived plans last.","tags":["Recurring payments"],"parameters":[{"name":"include_archived","in":"query","required":false,"description":"`true` — include archived plans.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 100, default 50.","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"items":[{"id":"5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f","name":"Pro","description":"Up to 10 projects and priority support","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/plans/{id}":{"get":{"operationId":"getPlan","summary":"Retrieve a plan","description":"Plan by ID.","tags":["Recurring payments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Plan ID.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f","name":"Pro","description":"Up to 10 projects and priority support","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/plans/{id}/archive":{"post":{"operationId":"archivePlan","summary":"Archive a plan","description":"No new subscriptions to the plan can be created. Existing subscriptions continue on the same terms.","tags":["Recurring payments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Plan ID.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f","name":"Pro","description":"Up to 10 projects and priority support","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/subscriptions":{"post":{"operationId":"createSubscription","summary":"Create a subscription","description":"Creates a subscription to a plan. Without a trial, the invoice for the first period is issued immediately — the payment link is in `current_invoice.payment_url`, and the customer also receives it by email. Repeating with the same `order_id` returns the existing subscription (response `200`).","tags":["Recurring payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plan_id"],"properties":{"plan_id":{"type":"string","description":"Plan ID."},"customer":{"type":"object","description":"Customer: `email` — where invoices and reminders are sent, `name`, `reference` — your user ID."},"order_id":{"type":"string","description":"Your unique subscription ID (up to 128 characters). Ensures idempotency."},"locale":{"type":"string","description":"Language of emails and the subscription page: `ru` (default) or `en`."},"start_at":{"type":"string","description":"Subscription start in the future (ISO 8601), at most one year ahead. Defaults to now."},"metadata":{"type":"object","description":"Arbitrary data — returned in responses and webhooks."}}},"example":{"plan_id":"5d0c1b8e-2f4a-4c3b-9e7d-1a2b3c4d5e6f","customer":{"email":"anna@example.com","name":"Anna","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":"Anna","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listSubscriptions","summary":"List subscriptions","description":"Subscriptions, newest first.","tags":["Recurring payments"],"parameters":[{"name":"status","in":"query","required":false,"description":"Filter by status.","schema":{"type":"string"}},{"name":"plan_id","in":"query","required":false,"description":"Subscriptions to one plan.","schema":{"type":"string"}},{"name":"order_id","in":"query","required":false,"description":"Find by your ID.","schema":{"type":"string"}},{"name":"customer_email","in":"query","required":false,"description":"A customer’s subscriptions by email.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1 to 100, default 20.","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"How many items to skip — for pagination.","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":"Anna","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/subscriptions/{id}":{"get":{"operationId":"getSubscription","summary":"Retrieve a subscription","description":"Current state of the subscription and the invoice for the next period.","tags":["Recurring payments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Subscription 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":"Anna","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/subscriptions/{id}/cancel":{"post":{"operationId":"cancelSubscription","summary":"Cancel a subscription","description":"Immediately (default) or at the end of the paid period. An unpaid invoice for the next period is cancelled. A subscription without a paid period (`pending`, `past_due`) is cancelled immediately. Repeating the call changes nothing.","tags":["Recurring payments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Subscription ID.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"at_period_end":{"type":"boolean","description":"`true` — cancel renewal: the subscription stays active until `current_period_end`, then becomes `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":"Anna","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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/buttons/{code}":{"get":{"operationId":"getButton","security":[],"summary":"Button data","description":"Public button data — no API key. A disabled or deleted button, or a button of an inactive store, returns `404`.","tags":["Payment buttons and widget"],"parameters":[{"name":"code","in":"path","required":true,"description":"Button code from the dashboard (“Payment buttons” section), e.g. `7KQ2M9XHTA`.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"code":"7KQ2M9XHTA","title":"1-hour consultation","description":"Zoom call","amount":"25","currency":"USD","custom_amount":false,"min_amount":null,"max_amount":null,"merchant":{"name":"Shop"},"url":"https://paymeusd.com/b/7KQ2M9XHTA"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/buttons/{code}/invoice":{"post":{"operationId":"createButtonInvoice","security":[],"summary":"Invoice from a button","description":"Creates a new invoice from a button (every call creates a new invoice) and returns the payment page link. No API key; called from the browser on any website.","tags":["Payment buttons and widget"],"parameters":[{"name":"code","in":"path","required":true,"description":"Button code from the dashboard (“Payment buttons” section), e.g. `7KQ2M9XHTA`.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"string","description":"Amount for a “customer enters the amount” button — required for it, within `min_amount`…`max_amount`. Ignored for fixed-amount buttons."},"email":{"type":"string","description":"Customer email — stored in the invoice `metadata.email`."},"comment":{"type":"string","description":"Customer comment (up to 500 characters) — stored in `metadata.comment`."},"return_url":{"type":"string","description":"Where to send the customer if they leave without paying. Accepted only if it matches the site the request came from (the `Origin` header); otherwise the button page is used."},"lang":{"type":"string","description":"Payment page language, e.g. `ru` or `en`."}}},"example":{"email":"buyer@example.com","comment":"Please do not call"}}}},"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":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Secret key sk_live_… or sk_test_…"}},"schemas":{"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}