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

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

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

Методы API

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

Справочник

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

Документы

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

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

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

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/invoicesНужный scope: invoices:write
    ПолеТипОбязательноОписание
    amountstringдаСумма инвойса, больше 0, до 6 знаков после точки
    currencystringнетUSDT (по умолчанию), USDC или USD. USD оплачивается в USDT 1:1
    networkstringнетtron, ton, solana, sim. Без сети плательщик выберет её на странице оплаты
    descriptionstringнетДо 1024 символов, показывается плательщику
    external_idstringнетВаш идентификатор того, за что этот инвойс: номер заказа, id пользователя, id пополнения. 1–64 символа: латинские буквы, цифры и _ - . :. Возвращается в ответах и вебхуках, по нему можно найти инвойсы: GET /invoices?external_id=…
    payloadstringнетДо 4 КБ произвольного текста (например, JSON). Возвращается в ответах и вебхуках как есть
    expires_inintнетСрок жизни в секундах, 300–86400, по умолчанию 3600
    fee_payerstringнетКто платит комиссию шлюза: merchant, payer, split. По умолчанию из настроек приложения
    return_urlstringнетКуда вернуть плательщика после оплаты. По умолчанию из настроек приложения
    • Без network в ответе "network": null и "address": null. Адрес выделяется, когда плательщик выберет сеть на pay_url.
    • Инвойс получает адрес из пула. Пока инвойс открыт, адрес закреплён только за ним. После закрытия инвойса адрес через паузу (по умолчанию 1 час) выдаётся другому инвойсу, возможно другого мерчанта. Не сохраняйте адрес как постоянные реквизиты плательщика и не давайте платить по адресу старого инвойса: см. правило 11 в разделе о статусах. Отправьте плательщика на pay_url или покажите address и pay_amount на своей странице.
    • asset это монета, в которой платят. При currency: "USD" это USDT.
    • На один external_id в приложении бывает один живой инвойс. Пока инвойс с этим external_id открыт (active, paying, partially_paid) или оплачен (paid, overpaid), второй создать нельзя: ошибка 409 EXTERNAL_ID_TAKEN. Когда инвойс истёк или отменён, на тот же external_id можно выставить новый. Чтобы узнать, оплачен ли заказ, запросите GET /invoices?external_id=order-5512&status=paid,overpaid.

    Комиссия шлюза и pay_amount. Комиссия fee = max(1 % от amount, 0.1), округление до 6 знаков.

    fee_payerpay_amount (платит плательщик)Мерчант получаетПример, amount = 100
    merchantamountamount − feeплатит 100, мерчант получает 99
    payeramount + feeamountплатит 101, мерчант получает 100
    splitamount + fee/2amount − fee/2платит 100.5, мерчант получает 99.5
    НазадGET/currenciesДальше GET/invoices
    Запрос
    curl -s "$API/invoices" -H "API-Token: $TOKEN" \
      -H "Content-Type: application/json" -H "Idempotency-Key: order-5512" \
      -d '{
        "amount": "100.00",
        "currency": "USDT",
        "network": "tron",
        "description": "Заказ №5512",
        "external_id": "order-5512",
        "payload": "order-5512",
        "expires_in": 3600,
        "return_url": "https://shop.example.com/thanks"
      }'
    Ответ
    {
      "ok": true,
      "result": {
        "invoice_id": 10452,
        "status": "active",
        "amount": "100.00",
        "currency": "USDT",
        "asset": "USDT",
        "network": "tron",
        "address": "TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp",
        "pay_amount": "100.00",
        "paid_amount": "0.00",
        "fee": "1.00",
        "fee_payer": "merchant",
        "pay_url": "https://pay.<домен>/i/Xq3vN8kT2pLmA9sd",
        "description": "Заказ №5512",
        "external_id": "order-5512",
        "payload": "order-5512",
        "testnet": false,
        "created_at": "2026-11-05T10:00:00Z",
        "expires_at": "2026-11-05T11:00:00Z",
        "paid_at": null
      }
    }