> ## 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.

# 获取法币流水

> 以复式记账视图获取商户的所有法币余额变动，包括交易明细、手续费条目和回滚事件。

使用此端点获取商户账户法币余额变动的细粒度账本。与资金记录（显示汇总交易）不同，法币流水记录会展示各条复式记账明细——包括单独的手续费条目、回滚事件和转账变动。这是构建实时余额对账和会计导出的推荐端点。

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

## 端点

`GET https://api.velafi.com/v2/merchant/fiat/flows`

## 查询参数

**merchantId** `integer`

按商户 ID 筛选。

**fiat** `string`

按法币代码筛选。

**txId** `integer`

按特定资金交易 ID 筛选。

**flowType** `string`

按流水类型筛选。可接受的值：

* `ALL` — 所有类型（默认）
* `DEPOSIT` — 入账存款
* `WITHDRAW` — 出账提现
* `WITHDRAW_ROLLBACK` — 提现撤销
* `BUY_CRYPTO` — 购买加密货币扣款
* `BUY_CRYPTO_ROLLBACK` — 购买加密货币撤销
* `REFUND` — 退款入账
* `REFUND_ROLLBACK` — 退款撤销
* `TRANSFER_IN` — 内部转账入账
* `TRANSFER_OUT` — 内部转账出账

**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** `number`

此法币流水明细的唯一 ID。

**merchantId** `number`

此流水明细所属的商户 ID。

**settingsId** `number`

商户账户（支付渠道设置）的 ID。

**txId** `string`

所属资金交易的 ID。

**category** `string`

高级类别：`TRADE`、`FEE` 或 `TRANSFER`。

**flowType** `string`

具体流水类型（参见上方查询参数的取值）。

**fiat** `string`

此流水明细的法币。

**changed** `number`

余额变动金额。正数 = 入账，负数 = 出账。

**total** `number`

应用此流水明细后的累计余额。

**extId** `string`

关联相关订单或记录的外部引用 ID。

**createTime** `string`

流水明细创建时的 Unix 时间戳（毫秒）。

## 示例

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

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "currentPage": 1,
    "size": 10,
    "total": 100,
    "record": [
      {
        "id": 282,
        "merchantId": 3,
        "settingsId": 3,
        "txId": "573901321954934784",
        "category": "TRADE",
        "flowType": "DEPOSIT",
        "fiat": "MXN",
        "changed": 105.61,
        "total": 37042.07,
        "extId": "573901321434841088",
        "createTime": "1737452292000"
      }
    ]
  }
}
```

> [!NOTE]
>
> 每笔交易通常会生成至少两条流水明细——一条用于本金的 `TRADE` 明细和一条用于手续费的 `FEE` 明细。在会计流程中可按 `category` 筛选以将二者区分开。


## Related topics

- [更新日志](https://docs.velafi.com/cn/docs/changelog.md)
- [获取法币/法币报价](https://docs.velafi.com/cn/api-reference/quote/get-user-quote-for-fiat-fiat.md)
- [获取法币列表](https://docs.velafi.com/cn/api-reference/basic-configuration/get-list-of-fiat-currencies.md)
- [获取法币→法币交易对](https://docs.velafi.com/cn/api-reference/basic-configuration/get-fiat-fiat-pairs.md)
- [获取法币→法币支付方式](https://docs.velafi.com/cn/api-reference/basic-configuration/get-fiat-fiat-payment-methods.md)


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