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

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

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

Методы API

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

Справочник

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

Документы

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

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

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

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-политика

    Методы API

    Вывод на внешний адрес

    POST/api/v1/withdrawalsНужный scope: withdrawals:write
    ПолеТипОбязательноОписание
    amountstringдаСписывается с баланса целиком, минимум 10
    currencystringнетUSDT по умолчанию. Монета должна быть в сети вывода
    networkstringдаtron, ton, solana, sim
    addressstringдаАдрес получателя, до 128 символов. Проверяется по формату сети
    memostringнетДо 128 символов. TON: текстовый comment jetton-перевода (его читают биржи). Solana: инструкция SPL Memo. TRON: у TRC-20 memo нет, запрос получит MEMO_NOT_SUPPORTED
    • С баланса списывается amount, получатель получает net_amount = amount − fee. fee это комиссия сети на момент заявки: TON 0.3, Solana 0.5, Simnet 0.2 (фиксированные), TRON от 3 (следует за курсом TRX, текущее значение в withdrawal_fee из /currencies).
    • Сумма сразу переходит из available в held.
    • Вывод может уйти несколькими переводами в сети, если нужной суммы нет на одном адресе шлюза. Получатель тогда видит несколько входящих транзакций, в сумме ровно net_amount. fee от числа переводов не зависит. txids: txid всех переводов, txid: первого из них.
    • Всегда передавайте Idempotency-Key: повтор после таймаута без ключа создаст второй вывод.
    • Проверки по порядку: сеть, монета, формат адреса, минимум 10 и сумма больше комиссии, чёрный список. Дальше только mainnet: подтверждённый email (EMAIL_NOT_VERIFIED), лимит закрытой беты на аккаунт (BETA_LIMIT), порог без верификации на аккаунт (KYC_REQUIRED, если KYC включён), дневной лимит приложения (по умолчанию 20 000 в сутки, меняет оператор), лимит нового аккаунта (не действует, если оператор задал аккаунту индивидуальный лимит). Последним баланс. Лимиты считаются по выводам за последние 24 часа в статусах pending, review, processing, completed; лимиты беты и KYC: по всем приложениям аккаунта.

    Ручная проверка (только mainnet). Вывод получает статус review и ждёт решения оператора, если выполнено любое условие:

    • сумма от 2000;
    • сумма выводов приложения за последний час вместе с этим выводом больше 5000;
    • аккаунту меньше 7 дней;
    • от порога AML (по умолчанию 1000) адрес получателя проверяется AML-провайдером, и проверка показала высокий риск или провайдер не ответил.

    В testnet-режиме ручной проверки, AML и лимитов нет.

    НазадGET/balanceДальше GET/withdrawals/{id}
    Запрос
    curl -s "$API/withdrawals" -H "API-Token: $TOKEN" \
      -H "Content-Type: application/json" -H "Idempotency-Key: payout-2026-11-05" \
      -d '{"amount": "250.00", "currency": "USDT", "network": "tron", "address": "TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp"}'
    Ответ
    {
      "ok": true,
      "result": {
        "withdrawal_id": 381,
        "status": "pending",
        "amount": "250.00",
        "fee": "1.00",
        "net_amount": "249.00",
        "currency": "USDT",
        "network": "tron",
        "address": "TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp",
        "memo": null,
        "txid": null,
        "txids": [],
        "error": null,
        "created_at": "2026-11-05T12:00:00Z"
      }
    }