GET /apiv2/billing/payments

Ваши платежи по постоплатным счетам и остаток кредита от переплат. Вы платите в валюте и сети вашего договора — см. settlement в аккаунте. Часть постоплатного биллинга.

URL эндпоинта

GET https://netts.io/apiv2/billing/payments

Заголовки запроса

Заголовок	Обязательный	Описание
X-API-KEY	да	API-ключ с разрешением billing.read
X-Real-IP	да	Адрес из белого списка ключа

Запрос не содержит параметров.

Пример

curl -s 'https://netts.io/apiv2/billing/payments' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "payments": [
      {
        "id": 7,
        "network": "ethereum",
        "txHash": "0x8f3c5a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5e21a",
        "fromAddress": "0x1111111111111111111111111111111111111111",
        "toAddress": "0x2222222222222222222222222222222222222222",
        "amountUsdc": "1300.000000",
        "confirmedAt": "2026-10-21T09:15:00+00:00",
        "status": "confirmed",
        "invoiceId": 12
      }
    ],
    "creditUsdc": "49.600000"
  },
  "timestamp": "2026-10-21T09:20:00+00:00"
}

Поля

Поле	Описание
network, txHash	сеть и транзакция платежа
fromAddress, toAddress	ваш кошелек и платежный адрес Netts
amountUsdc	полученная сумма в валюте вашего договора
confirmedAt	время зачисления платежа, UTC
status	confirmed или reversed, если платеж был отменен
invoiceId	счет, по которому был совершен платеж, или null
creditUsdc	средства, уплаченные сверх ваших счетов, в валюте вашего договора; они покрывают следующие начисления и отображаются как creditApplied в лимитах

Платеж, совершенный по счету, сначала покрывает начисления этого счета, затем — самые старые неоплаченные начисления; платеж без указания счета сначала покрывает самые старые неоплаченные начисления. Платежи отсортированы от новых к старым; для аккаунта без платежей возвращается пустой список.

Ошибки

HTTP	code	Значение
401	-1, -2	ключ отсутствует или недействителен, либо IP не входит в белый список — ответ API-шлюза, см. формат ответа
403	billing_read_required, postpaid_required	нет разрешения или отсутствует постоплатный биллинг