Ketmus
Esc

API Reference v1

Информация о счёте

Возвращает счёт с полученными платежами и доступными монетами.

GETapp.ketmus.com/api/merchant/v1/invoices/{id}

Возвращает полную информацию о счёте, включая список платежей payments и доступные мо��еты available_rails.

Параметры пути

idstringобязательный
Идентификатор счёта из поля invoice.id.

Пример запроса

curl "https://app.ketmus.com/api/merchant/v1/invoices/8f0c6a52-3f7e-4b8e-9d61-2c4b0f8a1e7d" \
  -H "Authorization: Bearer $KETMUS_API_KEY"

Поиск по номеру заказа

Чтобы найти счёт по вашему номеру заказа, передайте order_id в списке счетов — вернётся один счёт вместо списка:

GETapp.ketmus.com/api/merchant/v1/invoices?order_id=ORDER-1042

Ответ

{
  "invoice": {
    "type": "invoice",
    "id": "8f0c6a52-3f7e-4b8e-9d61-2c4b0f8a1e7d",
    "order_id": "ORDER-1042",
    "status": "paid",
    "is_final": true,
    "late_payment": false,
    "price": {
      "amount": "25",
      "currency": "USD"
    },
    "payment": {
      "rail": "usdt_tron",
      "asset": "USDT",
      "network": "tron",
      "address": "TQ7nX4yVh3cE9v5G2kRZb8aWm1pLd6sFJt",
      "memo": null,
      "amount_due": "25.31",
      "amount_received": "25.31",
      "amount_confirmed": "25.31",
      "late_amount": "0",
      "rate": "1",
      "txids": [
        "a3f1c0e9d2b84f7c9e61d0b5a2c7e4f8b1d9c3a6e5f2b7d0c4a8e1f6b3d9c2a7"
      ]
    },
    "fee": {
      "bps": 125,
      "payer": "payer",
      "amount": "0.31",
      "merchant_amount": "25"
    },
    "pay_url": "https://app.ketmus.com/checkout/inv_5Kq2ZtR8wLmA",
    "metadata": {
      "user_id": "u_731"
    },
    "created_at": "2026-11-03T10:15:00.000Z",
    "expires_at": "2026-11-03T11:15:00.000Z",
    "paid_at": "2026-11-03T10:21:42.000Z",
    "public_id": "inv_5Kq2ZtR8wLmA",
    "description": "Подписка Pro на 1 месяц",
    "lifetime_sec": 3600,
    "underpaid_coverage_bps": 0,
    "refresh_count": 0,
    "return_url": "https://shop.example.com/orders/1042",
    "success_url": "https://shop.example.com/orders/1042?paid=1",
    "fail_url": "https://shop.example.com/orders/1042?failed=1",
    "payer_email": null,
    "customer_id": null,
    "payment_uri": null,
    "explorer_address_url": "https://tronscan.org/#/address/TQ7nX4yVh3cE9v5G2kRZb8aWm1pLd6sFJt",
    "payments": [
      {
        "txid": "a3f1c0e9d2b84f7c9e61d0b5a2c7e4f8b1d9c3a6e5f2b7d0c4a8e1f6b3d9c2a7",
        "outputIndex": 0,
        "address": "TQ7nX4yVh3cE9v5G2kRZb8aWm1pLd6sFJt",
        "amount": "25.31",
        "confirmations": 20,
        "requiredConfirmations": 20,
        "confirmed": true,
        "late": false,
        "detectedAt": "2026-11-03T10:19:05.000Z",
        "explorer_url": "https://tronscan.org/#/transaction/a3f1c0e9d2b84f7c9e61d0b5a2c7e4f8b1d9c3a6e5f2b7d0c4a8e1f6b3d9c2a7"
      }
    ]
  }
}