Daftar pembayaran

Ikhtisar

Layanan otomatis menemukan semua pembayaran yang masuk ke dompet kripto Anda, tetapi hanya selama ada tagihan dengan pencarian aktif. Pencarian berjalan selama tagihan belum dibayar dan berlanjut satu jam lagi setelah batas waktu pembayaran—untuk mengantisipasi jaringan lambat. Jika tagihan seperti itu tidak ada, transaksi masuk tidak masuk ke sistem.

Permintaan

curl -X POST https://api.bitsby.app/payments/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
walletId	UUID	ID dompet dalam format UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	tidak
invoiceId	UUID	ID tagihan dalam format UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	tidak
startDate	String	Tanggal awal transaksi on-chain, dalam format Y-m-d	2000-01-01	tidak
endDate	String	Tanggal akhir transaksi on-chain, dalam format Y-m-d	2030-01-01	tidak
offset	Integer	Indeks rekaman pertama yang dikembalikan	0	tidak	0
limit	Integer	Jumlah rekaman yang ingin Anda terima	50	tidak	10

Contoh respons

Pembayaran yang sudah tercocokkan dengan tagihan:

{
   "result":"success",
   "data":[
      {
         "id":"f986ad8d-2298-473d-982a-efbc817b975d",
         "amount":12,
         "hash":"f09352627039c088688806821b864895ff237558612d834861621fc026de5f68",
         "transactionDatetime":"2024-02-27 21:05:36",
         "invoice":{
            "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":1,
            "status":"paid"
         },
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      },
      {
         "id":"f3195184-9a6f-4c82-928b-d7fe7c015b7b",
         "amount":5.02,
         "hash":"74763b65e43bcc9492a6ce9a7f26fbfdbd7635aecd3454420b5e9534cba50ee6",
         "transactionDatetime":"2024-02-26 13:32:57",
         "invoice":{
            "id":"fac8ef03-2c41-4ce0-a432-7c33b928f16f",
            "uid":"AFhygKX21ecd",
            "projectId":"9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime":"2024-02-26 13:29:24",
            "timeToPayDatetime":"2024-02-27 01:29:24",
            "commissionFiatUSD":0.05,
            "amountFiatUSD":5.02, 
            "amountFiat":5,
            "currencyFiat":"USD",
            "description":null,
            "serviceData":"orderId:3419",
            "views":3,
            "status":"paid"
         },
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      }
   ]
}

Pembayaran yang sudah ditemukan layanan tetapi belum tercocokkan dengan tagihan datang tanpa blok invoice. Pembayaran inilah kandidat pencocokan manual:

{
   "result":"success",
   "data":[
      {
         "id":"c1d0f4a2-93b7-4f61-8c25-1a6f0e2b7d94",
         "amount":9.87,
         "hash":"5b1e4b1cf0a4c3d2e9f6a7b8c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192",
         "transactionDatetime":"2024-02-28 09:14:02",
         "wallet":{
            "id":"47aa71e2-07a0-482e-9172-7114d7376ba0",
            "name":"usdt-tron",
            "blockchain":"tron",
            "cryptocurrency":"usdt",
            "address":"TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
         }
      }
   ]
}

Parameter respons

Parameter	Deskripsi
id	ID pembayaran dalam format UUID
amount	Jumlah pembayaran dalam mata uang kripto
hash	Hash transaksi on-chain
transactionDatetime	Tanggal dan waktu transaksi on-chain (UTC)
invoice	Blok berisi parameter tagihan. Ada jika ada tagihan yang tercocokkan dengan pembayaran
invoice.id	ID tagihan dalam format UUID
invoice.uid	ID tagihan (untuk pembeli)
invoice.projectId	ID proyek dalam format UUID
invoice.createDatetime	Tanggal dan waktu pembuatan tagihan (UTC)
invoice.timeToPayDatetime	Tanggal dan waktu hingga kapan tagihan berlaku (UTC)
invoice.commissionFiatUSD	Jumlah biaya layanan. Dihitung dari jumlah invoice.amountFiatUSD
invoice.amountFiatUSD	Jumlah tagihan yang dikonversi ke USD. Saat pembuatan tagihan dihitung dari invoice.amountFiat berdasarkan kurs terkini. Pada saat pembayaran ditimpa dengan jumlah yang benar-benar diterima, dikonversi ke USD dengan kurs saat itu. Biaya di invoice.commissionFiatUSD juga dihitung ulang darinya
invoice.amountFiat	Jumlah asli tagihan dalam mata uang fiat. Tidak berubah
invoice.currencyFiat	Mata uang fiat
invoice.description	Deskripsi yang diisi saat pembuatan tagihan
invoice.serviceData	Data layanan yang diisi saat pembuatan tagihan
invoice.views	Jumlah tampilan halaman pembayaran
invoice.status	Status tagihan
wallet	Blok berisi parameter dompet
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