# 付款列表 ## 概述 服务会自动找到进入加密钱包的所有付款，但只在存在检索中的收款单时进行。检索在收款单待支付期间进行，并在支付期限过后再持续 1 小时——照顾慢速网络。没有这样的收款单时，入账交易不会进入系统。 ## 请求 ```bash 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" ``` ## 请求参数 | 参数 | 数据类型 | 说明 | 示例 | 是否必填 | 默认值 | | ----------- | -------- | ----------------------------------- | ------------------------------------ | -------- | ------ | | `walletId` | UUID | 钱包 ID，UUID 格式 | 1c48b092-9878-48f5-b441-07a8a48e7b54 | 否 | | | `invoiceId` | UUID | 收款单 ID，UUID 格式 | 1c48b092-9878-48f5-b441-07a8a48e7b54 | 否 | | | `startDate` | String | 链上交易的起始日期，Y-m-d 格式 | 2000-01-01 | 否 | | | `endDate` | String | 链上交易的结束日期，Y-m-d 格式 | 2030-01-01 | 否 | | | `offset` | Integer | 返回的第一条记录的序号 | 0 | 否 | 0 | | `limit` | Integer | 希望获取的记录数 | 50 | 否 | 10 | ## 响应示例 已关联到收款单的付款： ```json { "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 块。这些付款就是手动关联的候选： ```json { "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` | 加密钱包地址 |