跳到主要内容

付款列表

概述​

服务会自动找到进入加密钱包的所有付款，但只在存在检索中的收款单时进行。检索在收款单待支付期间进行，并在支付期限过后再持续 1 小时——照顾慢速网络。没有这样的收款单时，入账交易不会进入系统。

请求​

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"

请求参数​

参数数据类型说明示例是否必填默认值
walletIdUUID钱包 ID，UUID 格式1c48b092-9878-48f5-b441-07a8a48e7b54否
invoiceIdUUID收款单 ID，UUID 格式1c48b092-9878-48f5-b441-07a8a48e7b54否
startDateString链上交易的起始日期，Y-m-d 格式2000-01-01否
endDateString链上交易的结束日期，Y-m-d 格式2030-01-01否
offsetInteger返回的第一条记录的序号0否0
limitInteger希望获取的记录数50否10

响应示例​

已关联到收款单的付款：

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

服务已找到但尚未关联到收款单的付款没有 invoice 块。这些付款就是手动关联的候选：

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

响应参数​

参数说明
id付款 ID，UUID 格式
amount以加密货币计的付款金额
hash链上交易哈希
transactionDatetime链上交易的日期和时间 (UTC)
invoice收款单参数块。付款已关联到收款单时存在
invoice.id收款单 ID，UUID 格式
invoice.uid收款单 ID（面向买家）
invoice.projectId项目 ID，UUID 格式
invoice.createDatetime收款单创建日期和时间 (UTC)
invoice.timeToPayDatetime收款单有效期截止的日期和时间 (UTC)
invoice.commissionFiatUSD服务费金额，按 invoice.amountFiatUSD 金额计算
invoice.amountFiatUSD折算成 USD 的收款单金额。创建收款单时按当时汇率由 invoice.amountFiat 换算。付款时被实际收到的金额覆盖，按付款时刻的汇率折算成 USD。invoice.commissionFiatUSD 中的服务费也随之重算
invoice.amountFiat收款单的法币原始金额，不会改变
invoice.currencyFiat法币币种
invoice.description创建收款单时填写的描述
invoice.serviceData创建收款单时填写的服务数据
invoice.views支付页面的浏览次数
invoice.status收款单状态
wallet钱包参数块
wallet.id钱包 ID，UUID 格式
wallet.name钱包名称
wallet.blockchain加密钱包所在的区块链
wallet.cryptocurrency钱包的加密货币
wallet.address加密钱包地址
最后于 更新