> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取资金记录

> 列出商户待处理资金 (Pending Fund) 账户的所有活动，包括存款、提现、加密货币购买、退款和内部转账。

使用此端点获取商户待处理资金 (Pending Fund) 账户的完整活动日志。每一笔入账和出账——无论是来自入账电汇、加密货币购买、资金提取（提现）、退款，还是商户之间的内部转账——都会记录在此。可按类型、状态、日期范围或 `clientId` 进行筛选，以生成对账报告或调查特定交易。

> [!NOTE]
>
> 所有请求都必须包含 `X-BH-TOKEN` 请求头，其中包含通过 `GET /v2/token/generate` 获取的业务令牌。

## 端点

`GET https://api.velafi.com/v2/merchant/funding/records`

## 查询参数

**txId** `integer`

按特定资金交易 ID 筛选。

**merchantId** `integer`

按商户 ID 筛选。

**fiat** `string`

按法币代码筛选。

**type** `string`

按交易类型筛选。可接受的值：

* `ALL` — 所有类型（默认）
* `DEPOSIT` — 存入账户的入账资金
* `WITHDRAW` — 从账户提取（提现）的资金
* `BUY_CRYPTO` — 用于购买加密货币的资金
* `REFUND` — 退回至账户的退款
* `TRANSFER_IN` — 从其他商户收到的资金
* `TRANSFER_OUT` — 转给其他商户的资金

**status** `integer`

按交易状态筛选：

* `0` — 全部（默认）
* `1` — 待处理
* `2` — 已完成
* `3` — 已取消
* `4` — 已退款

**clientId** `string`

按您提供的客户端订单标识符筛选。

**startTime** `integer`

日期范围的开始时间，以毫秒为单位的 Unix 时间戳。

**endTime** `integer`

日期范围的结束时间，以毫秒为单位的 Unix 时间戳。

**currentPage** `integer`

要获取的页码（从 1 开始）。默认为 `1`。

**pageSize** `integer`

每页记录数。默认为 `10`，最大为 `1000`。

## 响应字段

**code** `number`

HTTP 风格的响应码。`200` 表示成功。

**msg** `string`

人类可读的状态消息，例如 `SUCCESS`。

**data** `object`

**data 字段**

**currentPage** `number`

返回的当前页码。

**size** `number`

本页的记录数。

**total** `number`

符合查询条件的记录总数。

**record** `array`

**record 项字段**

**id** `string`

唯一资金交易 ID (txId)。

**merchantId** `number`

此记录所属的商户 ID。

**merchantName** `string`

商户的显示名称。

**fiat** `string`

交易的法币。

**totalAmount** `number`

包含手续费的法币总金额。

**amount** `number`

法币净金额（不含手续费）。

**fee** `number`

该交易收取的手续费。

**refundedAmount** `number`

已退款金额（如适用）。

**paymentId** `number`

支付渠道 ID。

**userPaymentId** `number`

用户的支付方式 ID。

**type** `string`

交易类型：`DEPOSIT`、`WITHDRAW`、`BUY_CRYPTO`、`REFUND`、`TRANSFER_IN`、`TRANSFER_OUT`。

**status** `number`

状态：`1` = 待处理，`2` = 已完成，`3` = 已取消，`4` = 已退款。

**taxId** `string`

存款实体的税务识别号。

**webhookInfo** `string`

包含该存款原始银行 Webhook 数据的 JSON 字符串。

**completedTime** `string`

交易完成时的 Unix 时间戳（毫秒）。

**refundedTime** `string`

退款发起时的 Unix 时间戳（毫秒）。

**createTime** `string`

记录创建时的 Unix 时间戳（毫秒）。

**updateTime** `string`

记录最后更新时的 Unix 时间戳（毫秒）。

**failCode** `number`

机器可读的失败代码（如适用）。

**failReason** `string`

人类可读的失败描述（如适用）。

## 示例

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/merchant/funding/records \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=3" \
  --data-urlencode "fiat=MXN" \
  --data-urlencode "type=DEPOSIT" \
  --data-urlencode "status=2" \
  --data-urlencode "pageSize=10"
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "currentPage": 1,
    "size": 10,
    "total": 100,
    "record": [
      {
        "id": "1123123123",
        "merchantId": 3,
        "merchantName": "Example Merchant",
        "fiat": "MXN",
        "totalAmount": 22.00,
        "amount": 20.00,
        "fee": 2.00,
        "refundedAmount": 0,
        "paymentId": 63,
        "userPaymentId": 91,
        "type": "DEPOSIT",
        "status": 2,
        "taxId": "20000000001",
        "webhookInfo": "{}",
        "completedTime": "1737452344000",
        "refundedTime": null,
        "createTime": "1737452292000",
        "updateTime": "1737452344000",
        "failCode": "",
        "failReason": ""
      }
    ]
  }
}
```


## Related topics

- [资金记录事件](https://docs.velafi.com/cn/api-reference/webhooks/funding-records-message-push.md)
- [更新日志](https://docs.velafi.com/cn/docs/changelog.md)
- [划转待处理资金](https://docs.velafi.com/cn/api-reference/merchant/transfer-pending-funds.md)
- [提取待处理资金](https://docs.velafi.com/cn/api-reference/merchant/claim-pending-fund.md)
- [获取法币流水](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-merchant-fiat-flow.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.