Paylane
ДокументацияСтатус
ВойтиСоздать аккаунт

Начало работы

  • Обзор
  • Адреса и окружения
  • Авторизация
  • Формат ответа
  • Ошибки
  • Идемпотентность
  • Лимиты

Методы API

  • Методы
  • GET/me
  • GET/currencies
  • POST/invoices
  • GET

Справочник

  • Инвойсы: статусы и жизненный цикл
  • Выводы: статусы
  • Вебхуки
  • Проверка подписи
  • Публичный API страницы оплаты
  • Testnet, mainnet и Simnet

Документы

  • Оферта для мерчантов
  • Политика конфиденциальности
  • AML/KYC-политика
Разделы: Ошибки

Начало работы

  • Обзор
  • Адреса и окружения
  • Авторизация
  • Формат ответа
  • Ошибки

Paylane

Paylane: приём платежей в стейблкоинах

Продукт

ДокументацияСтатусВойтиСоздать аккаунт

Документы

ОфертаКонфиденциальностьAML-политика
/invoices
  • GET/invoices/{id}
  • DELETE/invoices/{id}
  • GET/balance
  • POST/withdrawals
  • GET/withdrawals/{id}
  • GET/stats
  • POST/webhooks/test
  • POST/webhooks/{update_id}/resend
  • POST/sandbox/invoices/{id}/pay
  • POST/sandbox/events
  • Sandbox и тестовые сценарии
    Идемпотентность
  • Лимиты
  • Методы API

    • Методы
    • GET/me
    • GET/currencies
    • POST/invoices
    • GET/invoices
    • GET/invoices/{id}
    • DELETE/invoices/{id}
    • GET/balance
    • POST/withdrawals
    • GET/withdrawals/{id}
    • GET/stats
    • POST/webhooks/test
    • POST/webhooks/{update_id}/resend
    • POST/sandbox/invoices/{id}/pay
    • POST/sandbox/events

    Справочник

    • Инвойсы: статусы и жизненный цикл
    • Выводы: статусы
    • Вебхуки
    • Проверка подписи
    • Публичный API страницы оплаты
    • Testnet, mainnet и Simnet
    • Sandbox и тестовые сценарии

    Документы

    • Оферта для мерчантов
    • Политика конфиденциальности
    • AML/KYC-политика

    Ошибки

    HTTPcodeКогда
    400INVALID_REQUESTТело или параметры не прошли валидацию. В message поле и причина: amount: Input should be a valid string
    400INVALID_AMOUNTСумма не число, не больше нуля или длиннее 6 знаков после точки
    400UNSUPPORTED_CURRENCYВалюта инвойса не USD, USDT или USDC; монета не принимается в выбранной сети
    400UNSUPPORTED_NETWORKСеть выключена, не разрешена приложению или неизвестна; у приложения нет доступных сетей
    400AMOUNT_TOO_SMALLИнвойс меньше минимума сети; вывод меньше 10 или не больше комиссии сети
    400INVALID_FEE_PAYERfee_payer не merchant, payer или split
    400INVALID_EXPIRES_INexpires_in вне диапазона 300–86400 секунд
    400PAYLOAD_TOO_LARGEpayload больше 4096 байт в UTF-8
    409EXTERNAL_ID_TAKENИнвойс с таким external_id уже открыт или оплачен
    400INVALID_EXTERNAL_IDexternal_id пустой, длиннее 64 символов или содержит что-то кроме латинских букв, цифр и _ - . :
    400TOO_MANY_ACTIVE_INVOICESУ приложения уже 1000 открытых инвойсов (active, paying, partially_paid)
    400INVOICE_NOT_CANCELABLEОтменить можно только active-инвойс
    400INVALID_ADDRESSАдрес вывода не проходит проверку формата сети
    400MEMO_NOT_SUPPORTEDmemo передан для сети, где у перевода токена его нет (TRON)
    400ADDRESS_BLOCKEDАдрес вывода в чёрном списке оператора
    400DAILY_LIMITПревышен дневной лимит вывода приложения (mainnet)
    400NEW_ACCOUNT_LIMITАккаунту меньше 7 дней, лимит 1000 в сутки на все приложения аккаунта (mainnet)
    400EMAIL_NOT_VERIFIEDEmail аккаунта не подтверждён (mainnet-вывод)
    400BETA_LIMITНа время закрытой беты: выводы аккаунта за 24 часа вместе с этим больше лимита беты (mainnet)
    400KYC_REQUIREDТолько при PAYLANE_KYC_ENABLED=true (по умолчанию выключено). Аккаунт не верифицирован, а выводы аккаунта за 24 часа вместе с этим больше порога KYC, по умолчанию 10 000 (mainnet). Верификация: кабинет → «Верификация»
    400WEBHOOK_URL_MISSINGPOST /webhooks/test, POST /webhooks/{update_id}/resend или POST /sandbox/events без webhook_url в настройках приложения
    400INVOICE_CLOSEDSandbox-сценарий для закрытого инвойса
    400UNKNOWN_SCENARIOscenario не из списка
    400NOT_AVAILABLESandbox-сценарий для инвойса в настоящей тестовой сети (не sim)
    400PAYMENT_IN_FLIGHTСценарий expired или late, пока перевод ещё подтверждается
    400UNKNOWN_EVENTtype в POST /sandbox/events не test и не тип события из списка
    401UNAUTHORIZEDНет заголовка с токеном; токен не найден или отозван; аккаунт заблокирован
    402INSUFFICIENT_FUNDSНа available меньше суммы вывода
    403FORBIDDENУ токена нет нужного scope
    403LIVE_MODEМетод /sandbox/... вызван токеном боевого приложения
    404NOT_FOUNDИнвойс, вывод или событие не найдены или принадлежат другому приложению
    422IDEMPOTENCY_KEY_REUSEDIdempotency-Key уже использован с другим телом запроса
    429RATE_LIMITEDБольше 30 запросов в секунду на токен, см. Retry-After

    Обрабатывайте неизвестные code как общую ошибку: список будет расти.

    НазадФормат ответаДальше Идемпотентность