GET /apiv2/billing/payments

Seus pagamentos de faturas pós-pagas e o crédito restante de pagamentos a mais. Você paga na moeda e na rede do seu contrato — consulte settlement em conta. Parte da cobrança pós-paga.

URL do endpoint

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

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
X-API-KEY	sim	Chave de API com a permissão billing.read
X-Real-IP	sim	Um endereço da lista de permissões da chave

A requisição não tem parâmetros.

Exemplo

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	Descrição
network, txHash	a rede e a transação do pagamento
fromAddress, toAddress	sua carteira e o endereço de pagamento da Netts
amountUsdc	o valor recebido, na moeda do seu contrato
confirmedAt	quando o pagamento foi creditado, UTC
status	confirmed, ou reversed se o pagamento foi cancelado
invoiceId	a fatura para a qual o pagamento foi efetuado, ou null
creditUsdc	valor pago além das suas faturas, na moeda do seu contrato; cobre as próximas cobranças e é exibido como creditApplied em limites

Um pagamento realizado para uma fatura cobre as cobranças dessa fatura primeiro, depois as cobranças não pagas mais antigas; um pagamento sem fatura cobre as cobranças não pagas mais antigas primeiro. Os pagamentos são listados dos mais novos para os mais antigos; uma conta sem pagamentos recebe uma lista vazia.

Erros

HTTP	code	Significado
401	-1, -2	a chave está ausente ou é inválida, ou o IP não está na lista de permissões — respondido pelo gateway da API, consulte o formato de resposta
403	billing_read_required, postpaid_required	sem permissão ou sem cobrança pós-paga