Обзор Weelay

Что такое Weelay

Weelay — это некастодиальный checkout для приёма оплат в USDT TRC20.

Сервис помогает продавцу создать счёт, показать покупателю страницу оплаты, проверить поступление платежа в сети TRON и отправить продавцу webhook-уведомление о результате.

Weelay не хранит деньги покупателей и не управляет кошельками продавцов. Покупатель отправляет средства напрямую на USDT TRC20-адрес продавца.

Для кого подходит Weelay

Weelay подходит продавцам, которым нужен простой способ принимать оплату в USDT TRC20 через страницу оплаты и API.

Типовые сценарии:

• сайт или интернет-магазин;
• ручное создание счетов;
• backend-интеграция через API;
• приём оплаты за цифровые или обычные услуги;
• автоматическое обновление заказа через webhook;
• проверка статуса оплаты без собственного blockchain-мониторинга.

Главная идея

Обычная интеграция выглядит так:

1. Продавец создаёт проект в Weelay.
2. Продавец указывает свой USDT TRC20 wallet address.
3. Backend продавца создаёт счёт через API.
4. Weelay возвращает payment_url.
5. Покупатель открывает страницу оплаты.
6. Покупатель отправляет USDT TRC20 на адрес продавца.
7. Weelay проверяет blockchain-транзакцию.
8. Счёт получает статус paid, expired или другой итоговый статус.
9. Weelay отправляет webhook продавцу.
10. Продавец обновляет заказ в своей системе.

Роли сторон

В оплате участвуют три стороны.

Продавец создаёт проект, указывает wallet address, создаёт счёт и выполняет заказ перед покупателем.

Покупатель открывает страницу оплаты и отправляет USDT TRC20 на адрес продавца.

Weelay создаёт техническую инфраструктуру: счёт, страницу оплаты, проверку платежа, статус и webhook.

Weelay не является продавцом, банком, криптовалютной биржей или кошельком.

Некастодиальная модель

Weelay работает по некастодиальной модели.

Это значит:

• средства не проходят через баланс Weelay;
• Weelay не хранит USDT;
• Weelay не хранит приватные ключи продавца;
• Weelay не может списать деньги с кошелька продавца;
• Weelay не может выполнить возврат за продавца;
• blockchain-транзакцию обычно нельзя отменить после отправки.

Подробно это описано в документе Некастодиальное уведомление.

Что такое счёт

Счёт, или invoice, — это запись в Weelay, которая содержит сумму, валюту, статус, срок действия и ссылку на оплату.

Счёт нужен, чтобы связать оплату покупателя с конкретным заказом продавца.

Обычно продавец передаёт свой order_id, чтобы потом сопоставить счёт Weelay с заказом в своей системе.

Статусы оплаты

Счёт может иметь разные статусы.

Основные статусы:

• pending — счёт создан и ждёт оплату;
• paid — платёж найден и подтверждён;
• expired — срок оплаты истёк;
• failed — счёт не может быть успешно завершён.

Продавец должен выполнять заказ только после статуса paid.

Merchant API

Merchant API позволяет backend продавца работать с Weelay программно.

Через API можно:

• проверить данные текущего API-ключа;
• создать счёт;
• получить список счетов;
• получить один счёт;
• использовать Idempotency-Key для защиты от дублей.

Secret API key должен храниться только на backend продавца. Нельзя размещать его во frontend-коде, публичном JavaScript или открытых репозиториях.

Webhook

Webhook — это уведомление от Weelay к backend продавца.

Webhook нужен, чтобы продавец автоматически узнал об изменении статуса счёта и обновил заказ в своей системе.

Продавец должен обрабатывать webhook идемпотентно, потому что одно и то же событие может быть доставлено повторно.

Что нужно для старта

Для начала продавцу нужно:

1. Создать аккаунт Weelay.
2. Подтвердить email.
3. Создать проект.
4. Указать USDT TRC20 wallet address.
5. Создать secret API key.
6. Подключить создание счетов.
7. Настроить webhook endpoint.
8. Проверить тестовую оплату.
9. Перейти к реальному использованию.

Поддерживаемая оплата

Weelay поддерживает оплату в USDT TRC20.

Другие сети, токены, кастодиальные балансы, автоматические возвраты и встроенный кошелёк не являются базовой моделью сервиса.

Продавец отвечает за свой кошелёк, товары, услуги, поддержку покупателей и возвраты.

Куда идти дальше

Рекомендуемый порядок чтения:

1. Руководство подключения;
2. Merchant API;
3. Счета;
4. Статусы счетов;
5. Idempotency-Key;
6. Webhook-уведомления;
7. Ошибки API.

Для юридических деталей смотрите:

• Условия использования;
• Некастодиальное уведомление;
• Правила допустимого использования;
• Политика возвратов;
• Жалобы на продавца;
• Политика конфиденциальности.