Перейти к основному содержимому

Товары, управляемые ссылки и подписки

Это бизнес-ресурсы собственного аккаунта. Нужны API-ключ или партнёрская Bearer-сессия и включённые возможности. Ключ сам по себе не включает платёжный маршрут. См. авторизацию.

Для чтения и удаления env — query-фильтр. При создании и изменении товаров и ссылок передавайте env в JSON-теле. Владельца определяют реквизиты доступа; не передавайте чужой partner_id. Поля цены ресурса могут иметь целочисленный тип своего endpoint; amount транзакционного API остаётся строкой целого числа.

Товары​

GET /api/v1/products?env=prod&limit=10
GET /api/v1/products/{id}?env=prod
POST /api/v1/products
PUT /api/v1/products/{id}
DELETE /api/v1/products/{id}?env=prod

Создание товара задаёт header, text, price, qty и currency. Сам товар не является платежом. Списки возвращают data/total, детали и создание товара — data. Цена примера — 1 USDT при decimals=6.

{
  "env": "prod",
  "header": "Example item",
  "text": "Example item",
  "price": 1000000,
  "qty": "1",
  "currency": "USDT"
}

Управляемые платёжные ссылки​

GET /api/v1/links?env=prod&limit=10
POST /api/v1/links
PUT /api/v1/links/{id}
DELETE /api/v1/links/{id}?env=prod

Ссылки — отдельные серверные ресурсы с настройкой суммы, оплаты и необязательными товарами. Используйте URL или параметры формы из ответа, не придумывайте адрес. Ссылка получения, сформированная в Heth локально, — другой объект. Удаление ссылки не возвращает уже списанные деньги.

Подписки продавца​

GET /api/v1/recurrents?env=prod&limit=10
GET /api/v1/recurrents/{id}?env=prod
POST /api/v1/recurrents
PUT /api/v1/recurrents/{id}
POST /api/v1/recurrents/{id}/pause
POST /api/v1/recurrents/{id}/resume
POST /api/v1/recurrents/{id}/cancel

Подписка создаётся на основе успешного начального платежа собственного аккаунта. POST /recurrents принимает payment_id и объект recurrent; interval — daily, weekly, monthly или yearly, period — количество интервалов. Окружение наследуется от исходного платежа. Покупатель должен разрешить способ оплаты и условия последующих списаний. Создание записи подписки ещё не подтверждает наличие действующего разрешения на списание.

Для состояния используются POST /recurrents/{id}/pause, /resume и /cancel. Проверяйте ответ; отмена будущих списаний не возвращает предыдущие. Собственные криптовалютные акцепты плательщик Heth просматривает и отзывает со своей сессией кошелька в Настройках → Акцепты подписок, если функция доступна аккаунту. Это отдельный сценарий от управления подписками продавца.

Последнее обновление