GET /apiv2/billing/invoices

Ваши постоплатные инвойсы. В конце расчетного периода, установленного в вашем договоре, выставляется инвойс за услуги этого периода; у каждого инвойса есть срок оплаты. Часть постоплатного биллинга.

Эндпоинты

Эндпоинт	Возвращает
GET /apiv2/billing/invoices	все инвойсы, сначала за новейший период
GET /apiv2/billing/invoices/{id}	один инвойс с входящими в него списаниями

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

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

Пример

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

{
  "success": true,
  "data": {
    "id": 12,
    "periodStart": "2026-10-12T00:00:00+00:00",
    "periodEnd": "2026-10-19T00:00:00+00:00",
    "totalTrx": "3778.500000",
    "totalUsdc": "1250.400000",
    "paidUsdc": "0.000000",
    "status": "issued",
    "issuedAt": "2026-10-19T00:10:00+00:00",
    "dueAt": "2026-10-24T00:10:00+00:00",
    "charges": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "status": "invoiced"
      }
    ]
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

Каждое списание содержит те же поля, что и в использовании; в примере показаны некоторые из них.

Инвойс

Поле	Описание
id	номер инвойса
periodStart, periodEnd	расчетный период, покрываемый инвойсом, UTC
totalTrx, totalUsdc	общая сумма инвойса в TRX и в валюте вашего договора
paidUsdc	сколько уже оплачено в валюте вашего договора
status	issued, delivered, partially_paid, paid или void
issuedAt	когда был выставлен инвойс
dueAt	дата, до которой необходимо произвести оплату
charges	только в /invoices/{id}: списания инвойса

Эндпоинт со списком возвращает те же поля без charges. Аккаунт, у которого еще нет инвойсов, получает пустой список.

Ошибки

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