Ошибки
| HTTP | code | Когда |
|---|---|---|
| 400 | INVALID_REQUEST | Тело или параметры не прошли валидацию. В message поле и причина: amount: Input should be a valid string |
| 400 | INVALID_AMOUNT | Сумма не число, не больше нуля или длиннее 6 знаков после точки |
| 400 | UNSUPPORTED_CURRENCY | Валюта инвойса не USD, USDT или USDC; монета не принимается в выбранной сети |
| 400 | UNSUPPORTED_NETWORK | Сеть выключена, не разрешена приложению или неизвестна; у приложения нет доступных сетей |
| 400 | AMOUNT_TOO_SMALL | Инвойс меньше минимума сети; вывод меньше 10 или не больше комиссии сети |
| 400 | INVALID_FEE_PAYER | fee_payer не merchant, payer или split |
| 400 | INVALID_EXPIRES_IN | expires_in вне диапазона 300–86400 секунд |
| 400 | PAYLOAD_TOO_LARGE | payload больше 4096 байт в UTF-8 |
| 409 | EXTERNAL_ID_TAKEN | Инвойс с таким external_id уже открыт или оплачен |
| 400 | INVALID_EXTERNAL_ID | external_id пустой, длиннее 64 символов или содержит что-то кроме латинских букв, цифр и _ - . : |
| 400 | TOO_MANY_ACTIVE_INVOICES | У приложения уже 1000 открытых инвойсов (active, paying, partially_paid) |
| 400 | INVOICE_NOT_CANCELABLE | Отменить можно только active-инвойс |
| 400 | INVALID_ADDRESS | Адрес вывода не проходит проверку формата сети |
| 400 | MEMO_NOT_SUPPORTED | memo передан для сети, где у перевода токена его нет (TRON) |
| 400 | ADDRESS_BLOCKED | Адрес вывода в чёрном списке оператора |
| 400 | DAILY_LIMIT | Превышен дневной лимит вывода приложения (mainnet) |
| 400 | NEW_ACCOUNT_LIMIT | Аккаунту меньше 7 дней, лимит 1000 в сутки на все приложения аккаунта (mainnet) |
| 400 | EMAIL_NOT_VERIFIED | Email аккаунта не подтверждён (mainnet-вывод) |
| 400 | BETA_LIMIT | На время закрытой беты: выводы аккаунта за 24 часа вместе с этим больше лимита беты (mainnet) |
| 400 | KYC_REQUIRED | Только при PAYLANE_KYC_ENABLED=true (по умолчанию выключено). Аккаунт не верифицирован, а выводы аккаунта за 24 часа вместе с этим больше порога KYC, по умолчанию 10 000 (mainnet). Верификация: кабинет → «Верификация» |
| 400 | WEBHOOK_URL_MISSING | POST /webhooks/test, POST /webhooks/{update_id}/resend или POST /sandbox/events без webhook_url в настройках приложения |
| 400 | INVOICE_CLOSED | Sandbox-сценарий для закрытого инвойса |
| 400 | UNKNOWN_SCENARIO | scenario не из списка |
| 400 | NOT_AVAILABLE | Sandbox-сценарий для инвойса в настоящей тестовой сети (не sim) |
| 400 | PAYMENT_IN_FLIGHT | Сценарий expired или late, пока перевод ещё подтверждается |
| 400 | UNKNOWN_EVENT | type в POST /sandbox/events не test и не тип события из списка |
| 401 | UNAUTHORIZED | Нет заголовка с токеном; токен не найден или отозван; аккаунт заблокирован |
| 402 | INSUFFICIENT_FUNDS | На available меньше суммы вывода |
| 403 | FORBIDDEN | У токена нет нужного scope |
| 403 | LIVE_MODE | Метод /sandbox/... вызван токеном боевого приложения |
| 404 | NOT_FOUND | Инвойс, вывод или событие не найдены или принадлежат другому приложению |
| 422 | IDEMPOTENCY_KEY_REUSED | Idempotency-Key уже использован с другим телом запроса |
| 429 | RATE_LIMITED | Больше 30 запросов в секунду на токен, см. Retry-After |
Обрабатывайте неизвестные code как общую ошибку: список будет расти.