Интеграция криптоплатежей обычно начинается с одного вопроса: нужно ли создавать новый инвойс для каждого платежа клиента или каждому клиенту следует выдать многоразовый адрес для пополнения? Ответ зависит от сценария продукта.
Инвойсы лучше всего подходят для разовой оплаты заказов. Статические кошельки — для повторных пополнений, балансов и внесения средств на аккаунт клиента. Многие платформы используют обе модели в одном продукте.
Краткий ответ
Используйте криптоинвойс, когда клиент оплачивает конкретный заказ, сумму или сеанс оформления покупки. Используйте статический кошелёк, когда клиенту нужен постоянный адрес для пополнения криптовалютой, которым можно пользоваться многократно.
Например, для заказа в интернет-магазине обычно стоит использовать инвойс. Для баланса пользователя маркетплейса, игрового кошелька для пополнений или депозитного аккаунта Telegram-бота лучше подходят статические кошельки.
Когда использовать статические кошельки
Статический кошелёк закрепляет многоразовый адрес для пополнения за клиентом, аккаунтом на стороне мерчанта или внутренней сущностью. Клиент может неоднократно отправлять средства на один и тот же адрес, а серверная часть мерчанта сопоставляет входящие пополнения с нужным клиентом.
- Балансы клиентов и пополнение аккаунтов.
- Маркетплейсы, где продавцы или покупатели регулярно вносят средства.
- Игровые продукты, кошельки, боты и сервисы пополнения.
- Продукты, в которых сумма может меняться от пополнения к пополнению.
Подробнее о модели постоянного адреса для пополнения читайте на странице «Статические кошельки».
Когда использовать инвойсы
Криптоинвойс представляет собой один запрос на оплату. В нём указаны сумма, платёжные реквизиты, срок действия и статус. Мерчант создаёт инвойс для заказа, показывает платёжные данные и ожидает окончательного статуса.
- Разовые заказы при оформлении покупки.
- Платёжные ссылки на фиксированную сумму.
- Цифровые продукты и платные отчёты.
- Управляемое сервером оформление покупки с вебхуками.
Сценарий для разработчиков описан на странице API криптоинвойсов.
Сравнение моделей
Инвойсы проще использовать, когда клиент оплачивает один заказ. Статические кошельки удобнее, когда клиент будет пополнять баланс много раз. У инвойсов обычно есть срок действия, а статические кошельки рассчитаны на постоянное закрепление. Инвойсы ориентированы на заказ, статические кошельки — на аккаунт.
Главное операционное правило простое: не используйте постоянный адрес, если вам нужна строго определённая сумма разовой оплаты, и не создавайте лишние сеансы инвойсов, если продукт по своей природе является балансом или депозитным аккаунтом.
Рекомендации по интеграции
Какую бы модель вы ни выбрали, серверная часть должна сверять статус платежа, а не полагаться на скриншоты клиента или его намерение совершить перевод. Используйте вебхуки, проверки статуса и чёткие правила поддержки для недоплаченных, переплаченных и просроченных платежей или платежей в неправильной сети.
Для оплаты стейблкоинами начните со страницы «Приём платежей USDT». Для повторных пополнений используйте статические кошельки.
