Оплата кошельком и баланс
На сайте оплачивают точную сумму TRX из кошелька; продавец использует внутренний баланс. У каждого продавца отдельный адрес пополнения. Подтверждённый депозит увеличивает баланс, но сам по себе не создаёт заказ энергии. Кабинет и OpenAPI используют одинаковый процесс покупки.
Сначала рассчитайте точный объём
Запросите цену для нужного ресурса, количества и периода. Крупный заказ не обязательно равен цене единицы, умноженной на количество. Используйте полученные итоговую сумму и quote_id. Цена продавца действует минуту; после истечения получите новую.
Один заказ — один ключ
Передайте параметры продукта, кошелёк, quote_id и client_order_id. Один логический запрос использует один Idempotency-Key. После тайм-аута повторите исходный запрос с тем же ключом или проверьте заказ. Потерянный ответ не является основанием для новой покупки.
Принятие и доставка
Принятый заказ только начинает обрабатываться. Отслеживайте его по идентификатору или подписанным уведомлениям Webhook. Убедитесь в конечном статусе и подтверждении в блокчейне, прежде чем использовать энергию. Неопределённый результат требует сверки, а не повторной покупки.
Защитите интеграцию
Храните API Secret на своём сервере, настройте разрешённые IP и проверяйте подпись Webhook. Не записывайте полные секреты в журналы. Уведомления могут повторяться; обработчик должен быть идемпотентным.
Проверяйте цену аккаунта
Публичная цена API — стандартный ориентир. Продукты и итоговая цена аккаунтов могут отличаться. Начните с поддерживаемого объёма, проверьте весь цикл заказа, затем увеличивайте нагрузку, отслеживая баланс, ошибки и обработку уведомлений.