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	немає дозволу або відсутній білінг із післяоплатою