GET /apiv2/billing/payments

您针对后付费账单的付款，以及超额支付所剩余的额度。您需要使用合同规定的币种和网络进行支付 — 参见账户中的 settlement。属于后付费计费的一部分。

端点 URL

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

请求头

请求头	必填	描述
X-API-KEY	是	拥有 billing.read 权限的 API 密钥
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	无权限，或未开通后付费计费