Chuyển tới nội dung chính

Danh sách các khoản thanh toán

Tổng quan​

Dịch vụ tự động tìm mọi khoản thanh toán đến ví tiền mã hóa của bạn, nhưng chỉ khi còn hóa đơn đang trong quá trình tìm kiếm. Việc tìm kiếm chạy khi hóa đơn chưa thanh toán và tiếp tục thêm một giờ sau thời hạn thanh toán — để tính đến các mạng chậm. Nếu không có hóa đơn nào như vậy, giao dịch đến không vào hệ thống.

Yêu cầu​

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"

Tham số yêu cầu​

Tham sốKiểu dữ liệuMô tảVí dụBắt buộc?Mặc định
walletIdUUIDID ví ở định dạng UUID1c48b092-9878-48f5-b441-07a8a48e7b54không
invoiceIdUUIDID hóa đơn ở định dạng UUID1c48b092-9878-48f5-b441-07a8a48e7b54không
startDateStringNgày bắt đầu của giao dịch on-chain, định dạng Y-m-d2000-01-01không
endDateStringNgày kết thúc của giao dịch on-chain, định dạng Y-m-d2030-01-01không
offsetIntegerChỉ số của bản ghi đầu tiên cần trả về0không0
limitIntegerSố bản ghi bạn muốn nhận50không10

Ví dụ phản hồi​

Khoản thanh toán đã khớp với hóa đơn:

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

Khoản thanh toán dịch vụ đã tìm thấy nhưng chưa khớp với hóa đơn đến mà không có khối invoice. Những khoản này là ứng viên cho khớp thủ công:

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

Tham số phản hồi​

Tham sốMô tả
idID khoản thanh toán ở định dạng UUID
amountSố tiền thanh toán bằng tiền mã hóa
hashHash của giao dịch on-chain
transactionDatetimeNgày giờ của giao dịch on-chain (UTC)
invoiceKhối chứa tham số hóa đơn. Có mặt nếu có hóa đơn khớp với khoản thanh toán
invoice.idID hóa đơn ở định dạng UUID
invoice.uidID hóa đơn (dành cho người mua)
invoice.projectIdID dự án ở định dạng UUID
invoice.createDatetimeNgày giờ tạo hóa đơn (UTC)
invoice.timeToPayDatetimeNgày giờ hóa đơn còn hiệu lực đến (UTC)
invoice.commissionFiatUSDSố tiền phí dịch vụ. Tính từ số tiền invoice.amountFiatUSD
invoice.amountFiatUSDSố tiền hóa đơn quy đổi sang USD. Khi tạo hóa đơn, nó được tính từ invoice.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 invoice.commissionFiatUSD cũng được tính lại từ nó
invoice.amountFiatSố tiền gốc của hóa đơn bằng tiền pháp định. Không thay đổi
invoice.currencyFiatTiền pháp định
invoice.descriptionMô tả đặt khi tạo hóa đơn
invoice.serviceDataDữ liệu dịch vụ đặt khi tạo hóa đơn
invoice.viewsSố lượt xem trang thanh toán
invoice.statusTrạng thái hóa đơn
walletKhối chứa tham số ví
wallet.idID ví ở định dạng UUID
wallet.nameTên ví
wallet.blockchainBlockchain của ví tiền mã hóa
wallet.cryptocurrencyTiền mã hóa của ví
wallet.addressĐịa chỉ của ví tiền mã hóa
Cập nhật lần cuối vào