> ## 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) 转账之前，查询某种法币适用的商户间转账手续费——固定或按比例收费模式。

在商户账户之间转移资金之前，使用此接口获取适用的手续费。VelaFi 支持两种手续费模式：固定金额手续费和按比例手续费。请在调用[转移待处理资金](https://docs.velafi.com/cn/api-reference/merchant/transfer-pending-funds.md)之前查询手续费，以便向用户展示准确的费用信息。

> [!NOTE]
>
> 所有请求都必须在 `X-BH-TOKEN` 请求头中携带通过 `GET /v2/token/generate` 获取的业务令牌。目前支持的币种为 MXN 和 ARS。

## 接口地址

`GET https://api.velafi.com/v2/merchant/transfer_fee`

## 查询参数

**fiat** `string` *required*

要查询转账手续费的法币。支持的值：`MXN`、`ARS`。

## 响应字段

**code** `number`

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

**msg** `string`

可读的状态信息，例如 `SUCCESS`。

**data** `object`

**data 字段**

**fiat** `string`

该手续费适用的法币。

**feeType** `number`

手续费模式：`0` = 固定手续费，`1` = 按比例手续费。

**fee** `number`

手续费数值。对于按比例手续费（`feeType=1`），该值为 `0` 到 `1` 之间的小数（例如 `0.01` = 1%）。对于固定手续费（`feeType=0`），该值为固定的货币金额。

## 示例

> [tab] 按比例手续费
>
> ```bash cURL theme={null}
> curl -G https://api.velafi.com/v2/merchant/transfer_fee \
>   -H "X-BH-TOKEN: YOUR_TOKEN" \
>   --data-urlencode "fiat=MXN"
> ```
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "fiat": "MXN",
>     "feeType": 1,
>     "fee": 0.01
>   }
> }
> ```

> [tab] 固定手续费
>
> ```json Response theme={null}
> {
>   "code": 200,
>   "msg": "SUCCESS",
>   "data": {
>     "fiat": "MXN",
>     "feeType": 0,
>     "fee": 5
>   }
> }
> ```

> [!NOTE]
>
> 当 `feeType` 为 `1`（按比例）时，将 `fee` 乘以转账金额即可计算费用。例如，`fee` 为 `0.01` 时，一笔 1,000 MXN 的转账将产生 10 MXN 的手续费。


## Related topics

- [获取法币流水](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-merchant-fiat-flow.md)
- [获取提现额度](https://docs.velafi.com/cn/api-reference/crypto-wallet/get-withdrawal-quota.md)
- [获取加密货币→法币支付方式](https://docs.velafi.com/cn/api-reference/basic-configuration/get-crypto-fiat-payment-methods.md)
- [获取法币→法币支付方式](https://docs.velafi.com/cn/api-reference/basic-configuration/get-fiat-fiat-payment-methods.md)
- [提取待处理资金](https://docs.velafi.com/cn/api-reference/merchant/claim-pending-fund.md)


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