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

# 获取支持的支付方式

> 列出某个国家和法币可用的付款支付方式，以及每种方式的模板字段。

使用此接口查询某个国家和法币可用的付款支付方式，以及每种方式所需的模板字段。它返回的字段映射与[获取支付方式模板](https://docs.velafi.com/cn/api-reference/beneficiary/get-payment-templates.md)相同，但会在一次调用中返回所有符合条件的支付方式。

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

## 接口地址

`GET https://api.velafi.com/v2/payments/support/templates`

## 查询参数

**country** `string` *required*

英文国家名称，例如 `Mexico`、`Brazil` 或 `United States`。

**fiat** `string`

法币代码，例如 `MXN`。如果省略，`payments` 将为空。

## 响应字段

**code** `number`

`200` 表示成功。

**msg** `string`

成功时为 `SUCCESS`。

**data** `object`

**data 字段**

**payments** `array`

在指定国家和法币下可用于付款的支付方式。

**payments 条目字段**

**paymentId** `number`

支付方式 ID。添加收款人时将其用作 `paymentId`。

**country** `string`

此接口不填充该字段。

**paymentMethodName** `string`

支付方式名称。

**paymentType** `number`

支付方式类型代码。`0` 表示人工支付方式。

**fieldList** `object`

模板字段映射。每个键是字段的 `title`（参见[模板元数据](https://docs.velafi.com/cn/api-reference/beneficiary/get-payment-templates-metamessage.md)），每个值是该字段的默认文本，通常为空。如果两个字段的 title 相同，后出现的键会带有 `_<index>` 后缀，其中 `<index>` 为该字段的索引。对于包含账户持有人信息块的支付方式，映射中还会包含 `firstName`、`lastName` 和 `businessName` 中的一个或多个键。

## 示例

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/payments/support/templates \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "country=Mexico" \
  --data-urlencode "fiat=MXN"
```


## Related topics

- [获取支付方式模板](https://docs.velafi.com/cn/api-reference/beneficiary/get-payment-templates.md)
- [管理收款人](https://docs.velafi.com/cn/docs/guides/managing-beneficiaries.md)
- [支付方式](https://docs.velafi.com/cn/docs/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/basic-configuration/get-fiat-crypto-payment-methods.md)


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