GET /apiv2/billing/invoices

Sus facturas pospago. Al final del período de facturación establecido en su contrato, se emite una factura por los servicios de dicho período; cada factura tiene una fecha de vencimiento. Parte de la facturación pospago.

Endpoints

Endpoint	Devuelve
GET /apiv2/billing/invoices	todas las facturas, el período más reciente primero
GET /apiv2/billing/invoices/{id}	una factura con sus cargos

Encabezados de solicitud

Header	Requerido	Descripción
X-API-KEY	sí	Clave de API con el permiso billing.read
X-Real-IP	sí	Una dirección de la lista blanca de la clave

Ejemplos

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"
}

Cada cargo tiene los mismos campos que en uso; el ejemplo muestra algunos de ellos.

Una factura

Campo	Descripción
id	el número de factura
periodStart, periodEnd	el período de facturación que cubre la factura, UTC
totalTrx, totalUsdc	el total de la factura, en TRX y en la moneda de su contrato
paidUsdc	cuánto ya está pagado, en la moneda de su contrato
status	issued, delivered, partially_paid, paid o void
issuedAt	cuándo se emitió la factura
dueAt	la fecha límite de pago
charges	solo en /invoices/{id}: los cargos de la factura

El endpoint de lista devuelve los mismos campos sin charges. Una cuenta que aún no tenga facturas recibe una lista vacía.

Respuestas de error

HTTP	code	Significado
401	-1, -2	la clave falta o no es válida, o la IP no está en la lista blanca — respondido por la pasarela de la API, consulte el formato de respuesta
403	billing_read_required, postpaid_required	sin permiso, o sin facturación pospago
404	not_found	no existe dicha factura en su cuenta