Tạo một hóa đơn

Yêu cầu

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"

Tham số yêu cầu

Tham số	Kiểu dữ liệu	Mô tả	Ví dụ	Bắt buộc?
projectId	UUID	ID dự án ở định dạng UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	có
amountFiat	Float	Số tiền bằng tiền pháp định	10.55	có
currencyFiat	String	Tiền pháp định. Giá trị cho phép: USD, EUR, RUB	EUR	có
description	String	Mô tả sản phẩm hoặc dịch vụ. Hiển thị cho người mua trên trang thanh toán	12 months license for BITSBY	không
serviceData	String	Định danh đơn hàng phía cửa hàng. Không hiển thị cho người mua. Dữ liệu này liên kết hóa đơn và khoản thanh toán với người mua trong cửa hàng của người bán. JSON là định dạng thuận tiện cho dữ liệu này	{"userId":100,"orderId":500}	không
timeToPay	Float	Thời gian thanh toán hóa đơn, tính bằng giờ. Giá trị cho phép: 0.5, 1, 3, 6, 12	1	có

Ví dụ phản hồi

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

Tham số phản hồi

Tham số	Mô tả
id	ID hóa đơn ở định dạng UUID
uid	ID hóa đơn (dành cho người mua)
createDatetime	Ngày giờ tạo hóa đơn (UTC)
timeToPayDatetime	Ngày giờ hóa đơn còn hiệu lực đến (UTC). Người mua phải thanh toán hóa đơn trước thời điểm này
commissionFiatUSD	Số tiền phí dịch vụ. Tính từ số tiền amountFiatUSD
amountFiatUSD	Số tiền bằng USD, tính khi tạo hóa đơn từ invoice.amountFiat theo tỷ giá hiện tại
url	Liên kết đến trang thanh toán dành cho người mua. Gửi liên kết này cho người mua để thanh toán hóa đơn