Membuat tagihan

Permintaan

curl -X POST https://api.bitsby.app/invoices/create \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "projectId=9deea1e2-0c08-41a3-bdc2-a34eada3892d" \
	-F "amountFiat=10.55" \
	-F "currencyFiat=EUR" \
	-F "description=12 months license for BITSBY" \
	-F "serviceData={\"userId\":100,\"orderId\":500}" \
	-F "timeToPay=12"

Parameter permintaan

Parameter	Tipe data	Deskripsi	Contoh	Wajib?
projectId	UUID	ID proyek dalam format UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	ya
amountFiat	Float	Jumlah dalam mata uang fiat	10.55	ya
currencyFiat	String	Mata uang fiat. Nilai yang diizinkan: USD, EUR, RUB	EUR	ya
description	String	Deskripsi produk atau jasa. Ditampilkan kepada pembeli di halaman pembayaran	12 months license for BITSBY	tidak
serviceData	String	Identifikasi pesanan di sisi toko. Tidak ditampilkan kepada pembeli. Data ini mengaitkan tagihan dan pembayaran dengan pembeli di toko merchant. JSON adalah format yang praktis untuknya	{"userId":100,"orderId":500}	tidak
timeToPay	Float	Waktu untuk membayar tagihan, dalam jam. Nilai yang diizinkan: 0.5, 1, 3, 6, 12	1	ya

Contoh respons

{
   "result":"success",
   "data":{
      "id":"ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c",
      "uid":"MXNj4m8HhcM4",
      "createDatetime":"2024-02-29 15:20:24",
      "timeToPayDatetime":"2024-03-01 03:20:24",
      "commissionFiatUSD":0.1,
      "amountFiatUSD":10,
      "url":"https:\/\/dash.bitsby.app\/invoices\/pay\/MXNj4m8HhcM4"
   }
}

Parameter respons

Parameter	Deskripsi
id	ID tagihan dalam format UUID
uid	ID tagihan (untuk pembeli)
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 dalam USD, dihitung saat pembuatan tagihan dari invoice.amountFiat berdasarkan kurs terkini
url	Tautan halaman pembayaran untuk pembeli. Kirim tautan ini kepada pembeli untuk membayar tagihan