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

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

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

Методы API

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

Справочник

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

Документы

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

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

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

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

    Testnet, mainnet и Simnet

    Режим задаёт приложение. При создании приложения в кабинете ставится флаг testnet. Токен testnet-приложения работает только с тестовыми сетями, балансы у него отдельные. Признак режима есть в GET /me (testnet) и в каждом инвойсе и выводе.

    MainnetTestnet
    TRONUSDT TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t, USDC TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8Nile, USDT TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf
    TONUSDT EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDsTestnet, учебный USDT EQBqSpvo4S87mX9tjHaG4zhYZeORhVhMapBJpnMZ64jhrEQK: 1000 штук за перевод 0.1 TON на этот адрес с комментарием Mint:1
    SolanaUSDT Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB, USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vDevnet, USDC 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU (faucet Circle)
    SimnetнетUSDT, USDC (локальная симуляция)
    Обозревательhttps://tronscan.org, https://tonviewer.com, https://solscan.iohttps://nile.tronscan.org, https://testnet.tonviewer.com, https://solscan.io/?cluster=devnet
    Webhook URLтолько HTTPSHTTPS или HTTP
    Выводыручная проверка, дневные лимиты, AML, email, KYC, лимит бетыбез ручной проверки и лимитов

    Публичный testnet Paylane разворачивается отдельно от mainnet, со своей базой и своим хостом API (api.<домен testnet>). На любом из них testnet-приложение работает только с тестовыми сетями.

    Simnet это локальная симулированная сеть для разработки. Код сети sim, блок каждые 3 секунды, 3 подтверждения, адреса в формате TRON. Работает только в testnet-режиме и только там, где она включена (PAYLANE_ENABLED_NETWORKS содержит "sim"). На mainnet её не включают.

    Полный цикл без настоящих денег
    uv run paylane init-dev && uv run paylane migrate && uv run paylane dev --port 8000
    # 1. http://localhost:3040/register (кабинет из `paylane dev --web`): аккаунт, приложение с флагом testnet, токен
    # 2. Инвойс в Simnet:
    curl -s "http://127.0.0.1:8000/api/v1/invoices" -H "API-Token: $TOKEN" \
      -H "Content-Type: application/json" -d '{"amount": "25.50", "network": "sim", "payload": "o-1"}'
    # 3. Открыть pay_url, нажать «Симулировать оплату» или вызвать POST /sandbox/invoices/{id}/pay
    # 4. Через секунду:
    curl -s "http://127.0.0.1:8000/api/v1/invoices/<invoice_id>" -H "API-Token: $TOKEN"
    #    status: paid; баланс: available 25.245 (25.50 минус 1 %)

    Чтобы локальный сервер мог доставлять вебхуки на ваш ноутбук или на http://-адрес, используйте testnet-приложение. Для вызова извне нужен туннель (ngrok, rift и т. п.).

    НазадПубличный API страницы оплатыДальше Sandbox и тестовые сценарии