Danh sách hóa đơn
Yêu cầu
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"
Tham số yêu cầu
| Tham số | Kiểu dữ liệu | Mô tả | Ví dụ | Bắt buộc? | Mặc định |
|---|---|---|---|---|---|
invoiceId | UUID | ID hóa đơn ở định dạng UUID | 1c48b092-9878-48f5-b441-07a8a48e7b54 | không | |
invoiceUid | String | ID hóa đơn (dành cho người mua) | F7ncQviM1N92 | không | |
projectId | UUID | ID dự án ở định dạng UUID | 1c48b092-9878-48f5-b441-07a8a48e7b54 | không | |
startDate | String | Ngày bắt đầu tạo hóa đơn, định dạng Y-m-d | 2000-01-01 | không | |
endDate | String | Ngày kết thúc tạo hóa đơn, định dạng Y-m-d | 2030-01-01 | không | |
status | String | Trạng thái hóa đơn. Giá trị cho phép: unpaid, canceled, paid, expired | paid | không | |
offset | Integer | Chỉ số của bản ghi đầu tiên cần trả về | 0 | không | 0 |
limit | Integer | Số bản ghi bạn muốn nhận | 50 | không | 10 |
Ví dụ phản hồi
{
"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"
}
}
]
}
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) |
projectId | ID dự án ở định dạng UUID |
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 hóa đơn quy đổi sang USD. Khi tạo hóa đơn, nó được tính từ amountFiat theo tỷ giá hiện tại. Tại thời điểm thanh toán, nó bị ghi đè bằng số tiền thực nhận, quy đổi sang USD theo tỷ giá lúc đó. Phí trong commissionFiatUSD cũng được tính lại từ nó |
amountFiat | Số tiền gốc của hóa đơn bằng tiền pháp định. Không thay đổi |
currencyFiat | Tiền pháp định |
description | Mô tả đặt khi tạo hóa đơn. Hiển thị cho người mua |
serviceData | Dữ liệu dịch vụ đặt khi tạo hóa đơn. Không hiển thị cho người mua. Dùng để nhận diện hóa đơn và khoản thanh toán trong cửa hàng của người bán |
views | Số lượt xem trang thanh toán |
status | Trạng thái hóa đơn |
payment | Khối chứa tham số khoản thanh toán. Có mặt nếu hóa đơn đã được thanh toán |
payment.id | ID khoản thanh toán ở định dạng UUID |
payment.amount | Số tiền thanh toán bằng tiền mã hóa |
payment.hash | Hash của giao dịch on-chain |
payment.transactionDatetime | Ngày giờ của giao dịch on-chain (UTC) |
wallet | Khối chứa tham số của ví đã nhận khoản thanh toán. Có mặt nếu hóa đơn đã được thanh toán |
wallet.id | ID ví ở định dạng UUID |
wallet.name | Tên ví |
wallet.blockchain | Blockchain của ví tiền mã hóa |
wallet.cryptocurrency | Tiền mã hóa của ví |
wallet.address | Địa chỉ của ví tiền mã hóa |