GET /apiv2/billing/payments

Pembayaran Anda untuk faktur pascabayar, dan sisa kredit dari kelebihan pembayaran. Anda membayar dalam mata uang dan jaringan kontrak Anda — lihat settlement di akun. Bagian dari penagihan pascabayar.

URL Endpoint

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

Header Permintaan

Header	Wajib	Deskripsi
X-API-KEY	ya	Kunci API dengan izin billing.read
X-Real-IP	ya	Alamat dari daftar putih (whitelist) kunci

Permintaan ini tidak memiliki parameter.

Contoh

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

Bidang

Bidang	Deskripsi
network, txHash	jaringan dan transaksi pembayaran
fromAddress, toAddress	dompet Anda dan alamat pembayaran Netts
amountUsdc	jumlah yang diterima, dalam mata uang kontrak Anda
confirmedAt	waktu pembayaran dikreditkan, UTC
status	confirmed, atau reversed jika pembayaran dibatalkan
invoiceId	faktur tujuan pembayaran dilakukan, atau null
creditUsdc	uang yang dibayarkan melebihi faktur Anda, dalam mata uang kontrak Anda; ini menutupi tagihan berikutnya dan ditampilkan sebagai creditApplied di batas

Pembayaran yang dilakukan untuk suatu faktur akan menutupi biaya faktur tersebut terlebih dahulu, kemudian biaya tertunggak yang paling lama; pembayaran tanpa faktur akan menutupi biaya tertunggak yang paling lama terlebih dahulu. Pembayaran dicantumkan dari yang terbaru; akun tanpa pembayaran akan menerima daftar kosong.

Kesalahan

HTTP	code	Arti
401	-1, -2	kunci tidak ada atau tidak valid, atau IP tidak terdaftar di daftar putih — dijawab oleh gateway API, lihat format respons
403	billing_read_required, postpaid_required	tidak ada izin, atau tidak ada penagihan pascabayar