Testnet, mainnet и Simnet
Режим задаёт приложение. При создании приложения в кабинете ставится флаг testnet. Токен testnet-приложения работает только с тестовыми сетями, балансы у него отдельные. Признак режима есть в GET /me (testnet) и в каждом инвойсе и выводе.
| Mainnet | Testnet | |
|---|---|---|
| TRON | USDT TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t, USDC TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8 | Nile, USDT TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf |
| TON | USDT EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs | Testnet, учебный USDT EQBqSpvo4S87mX9tjHaG4zhYZeORhVhMapBJpnMZ64jhrEQK: 1000 штук за перевод 0.1 TON на этот адрес с комментарием Mint:1 |
| Solana | USDT Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB, USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v | Devnet, USDC 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU (faucet Circle) |
| Simnet | нет | USDT, USDC (локальная симуляция) |
| Обозреватель | https://tronscan.org, https://tonviewer.com, https://solscan.io | https://nile.tronscan.org, https://testnet.tonviewer.com, https://solscan.io/?cluster=devnet |
| Webhook URL | только HTTPS | HTTPS или 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 и т. п.).