Daftar tagihan

Permintaan

curl -X POST https://api.bitsby.app/invoices/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "startDate=2000-01-01" \
	-F "endDate=2030-01-01" \
	-F "offset=0" \
	-F "limit=10"

Parameter permintaan

Parameter	Tipe data	Deskripsi	Contoh	Wajib?	Bawaan
invoiceId	UUID	ID tagihan dalam format UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	tidak
invoiceUid	String	ID tagihan (untuk pembeli)	F7ncQviM1N92	tidak
projectId	UUID	ID proyek dalam format UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	tidak
startDate	String	Tanggal awal pembuatan tagihan, dalam format Y-m-d	2000-01-01	tidak
endDate	String	Tanggal akhir pembuatan tagihan, dalam format Y-m-d	2030-01-01	tidak
status	String	Status tagihan. Nilai yang diizinkan: unpaid, canceled, paid, expired	paid	tidak
offset	Integer	Indeks rekaman pertama yang dikembalikan	0	tidak	0
limit	Integer	Jumlah rekaman yang ingin Anda terima	50	tidak	10

Contoh respons

{
    "result": "success",
    "data": [
        {
            "id": "59302b02-d1be-4e10-960f-d6ec24bfcaaf",
            "uid": "F7nYgvxM1N92",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime": "2024-02-29 10:49:56",
            "timeToPayDatetime": "2024-02-29 22:49:56",
            "commissionFiatUSD": 1,
            "amountFiatUSD": 100,
            "amountFiat": 100,
            "currencyFiat": "USD",
            "description": null,
            "serviceData": null,
            "views": 0,
            "status": "canceled"
        },
        {
            "id": "f31c61f6-407f-4999-95cf-56477eff06d4",
            "uid": "riUZBnNvd2rX",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime": "2024-02-27 20:57:23",
            "timeToPayDatetime": "2024-02-28 08:57:23",
            "commissionFiatUSD": 0.12,
            "amountFiatUSD": 12,
            "amountFiat": 12,
            "currencyFiat": "USD",
            "description": null,
            "serviceData": "orderId:2444",
            "views": 3,
            "status": "paid",
            "payment": {
                "id": "f986ad8d-2298-473d-982a-efbc817b975d",
                "amount": 12,
                "hash": "f09352627039c088688806821b864895ff237558612d834861621fc026de5f68",
                "transactionDatetime": "2024-02-27 21:05:36"
            },
            "wallet": {
                "id": "47aa71e2-07a0-482e-9172-7114d7376ba0",
                "name": "usdt-tron",
                "blockchain": "tron",
                "cryptocurrency": "usdt",
                "address": "TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
            }
        }
    ]
}

Parameter respons

Parameter	Deskripsi
id	ID tagihan dalam format UUID
uid	ID tagihan (untuk pembeli)
projectId	ID proyek dalam format UUID
createDatetime	Tanggal dan waktu pembuatan tagihan (UTC)
timeToPayDatetime	Tanggal dan waktu hingga kapan tagihan berlaku (UTC). Pembeli harus membayar tagihan sebelum waktu ini
commissionFiatUSD	Jumlah biaya layanan. Dihitung dari jumlah amountFiatUSD
amountFiatUSD	Jumlah tagihan yang dikonversi ke USD. Saat pembuatan tagihan dihitung dari amountFiat berdasarkan kurs terkini. Pada saat pembayaran ditimpa dengan jumlah yang benar-benar diterima, dikonversi ke USD dengan kurs saat itu. Biaya di commissionFiatUSD juga dihitung ulang darinya
amountFiat	Jumlah asli tagihan dalam mata uang fiat. Tidak berubah
currencyFiat	Mata uang fiat
description	Deskripsi yang diisi saat pembuatan tagihan. Ditampilkan kepada pembeli
serviceData	Data layanan yang diisi saat pembuatan tagihan. Tidak ditampilkan kepada pembeli. Dipakai untuk mengidentifikasi tagihan dan pembayaran di toko merchant
views	Jumlah tampilan halaman pembayaran
status	Status tagihan
payment	Blok berisi parameter pembayaran. Ada jika tagihan sudah dibayar
payment.id	ID pembayaran dalam format UUID
payment.amount	Jumlah pembayaran dalam mata uang kripto
payment.hash	Hash transaksi on-chain
payment.transactionDatetime	Tanggal dan waktu transaksi on-chain (UTC)
wallet	Blok berisi parameter dompet yang menerima pembayaran. Ada jika tagihan sudah dibayar
wallet.id	ID dompet dalam format UUID
wallet.name	Nama dompet
wallet.blockchain	Blockchain dompet kripto
wallet.cryptocurrency	Mata uang kripto dompet
wallet.address	Alamat dompet kripto