Создать аккаунт Кабинет
Все статьи Продукт

Статические адреса: постоянный адрес пополнения для каждого клиента

Когда счёт на фиксированную сумму не подходит — балансы пользователей, депозиты, донаты без суммы. Один запрос — и у клиента есть адрес навсегда.

4 мин чтения

Обычный счёт живёт ограниченное время и ждёт конкретную сумму. Но есть сценарии, где сумма заранее неизвестна, а платежи повторяются: пополнение баланса в сервисе, депозиты в играх, донаты. Для них в Ketmus есть статические адреса.

Как это работает

Вы создаёте адрес одним запросом, указав монету с сетью (rail) и свой идентификатор клиента (customer_id). Адрес закрепляется за этим клиентом навсегда: каждое поступление на него Ketmus зачисляет на баланс проекта и отправляет webhook static.payment с customer_id и суммой.

curl -X POST https://app.ketmus.com/api/merchant/v1/static-addresses \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "rail": "usdt_tron",
    "customer_id": "user-8842",
    "callback_url": "https://shop.example/webhooks/ketmus"
  }'

Список уже выданных адресов возвращает GET /api/merchant/v1/static-addresses. Доступные значения rail — в ответе GET /api/merchant/v1/rails или на странице поддерживаемых монет.

Где это полезно

  • Личный кабинет с балансом: пользователь пополняет его в любое время на любую сумму.
  • Донаты и сборы без фиксированной суммы — адрес можно разместить прямо на странице.
  • Повторяющиеся платежи от одного контрагента, когда создавать счёт на каждый перевод неудобно.

Выбирайте счета, когда нужна точная сумма и срок оплаты, и статические адреса — когда важнее постоянство адреса. Оба инструмента доступны в одном проекте с одним ключом API.

Читайте также