Ketmus
Esc

API Reference v1

Статические адреса

Постоянный адрес пополнения для каждого клиента без создания счетов.

Статический адрес закрепляется за парой «клиент + монета» и не истекает. Подходит для пополнения баланса в играх, сервисах и ботах: клиент сохраняет ��дрес и пополняет его в любое время. Каждый подтверждённый перевод становится отдельным оплаченным счётом и вызывает вебхук static.payment.

Получить адрес

POSTapp.ketmus.com/api/merchant/v1/static-addresses
railstringобязательный
Монета и сеть, например usdt_tron.
customer_idstringобязательный
Ваш идентификатор клиента, до 120 символов.
callback_urlstring
URL для вебхуков static.payment. По умолчанию — из настроек магазина.

Метод идемпотентный: повторный вызов с тем же rail и customer_id вернёт уже выданный адрес, а не создаст новый.

curl -X POST "https://app.ketmus.com/api/merchant/v1/static-addresses" \
  -H "Authorization: Bearer $KETMUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rail": "usdt_tron",
    "customer_id": "user_731",
    "callback_url": "https://game.example.com/webhooks/ketmus"
  }'

Ответ

{
  "address": {
    "id": "0b6e2f9a-7c41-4d3e-8a52-19f6c0d4b7e3",
    "projectId": 42,
    "rail": "usdt_tron",
    "customerId": "user_731",
    "address": "TXa1Pq9vRk3mZcB7dWn4yH2sLf8gUe6oJt",
    "memo": null,
    "callbackUrl": "https://game.example.com/webhooks/ketmus",
    "createdAt": "2026-11-03T09:00:00.000Z",
    "asset": "USDT",
    "network": "tron"
  }
}

Список адресов

GETapp.ketmus.com/api/merchant/v1/static-addresses
curl "https://app.ketmus.com/api/merchant/v1/static-addresses" \
  -H "Authorization: Bearer $KETMUS_API_KEY"

Уведомление о пополнении

При каждом подтверждённом переводе приходит событие static.payment — с полями счёта и вашим customer_id. Зачислите сумму fee.merchant_amount или payment.amount_confirmed на баланс клиента.