GET /apiv2/billing/payments

Sus pagos de facturas pospago y el crédito restante de pagos en exceso. Usted paga en la moneda y red de su contrato — consulte settlement en cuenta. Parte de la facturación pospago.

URL del endpoint

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

Encabezados de solicitud

Encabezado	Obligatorio	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

La solicitud no tiene parámetros.

Ejemplo

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

Campos

Campo	Descripción
network, txHash	la red y la transacción del pago
fromAddress, toAddress	su billetera y la dirección de pago de Netts
amountUsdc	el monto recibido, en la moneda de su contrato
confirmedAt	cuándo se acreditó el pago, UTC
status	confirmed, o reversed si el pago fue cancelado
invoiceId	la factura para la cual se realizó el pago, o null
creditUsdc	dinero pagado por encima de sus facturas, en la moneda de su contrato; cubre los siguientes cargos y se muestra como creditApplied en límites

Un pago realizado para una factura cubre primero los cargos de esa factura, luego los cargos pendientes más antiguos; un pago sin factura cubre primero los cargos pendientes más antiguos. Los pagos se muestran ordenados desde el más reciente; una cuenta sin pagos recibe una lista vacía.

Errores

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 API, consulte el formato de respuesta
403	billing_read_required, postpaid_required	sin permiso, o sin facturación pospago