配置
获取法币→法币支付方式
获取法币到法币全球支付通道的支付方式，分别返回付款币种和收款币种的支付方式列表。
GET
/
v2
/
base
/
fiat
/
payments
获取法币→法币支付方式
curl --request GET \
--url https://api-test.velafi.com/v2/base/fiat/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/fiat/payments"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/base/fiat/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/base/fiat/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"onRampCountry": "<string>",
"onRampFiat": "<string>",
"offRampCountry": "<string>",
"offRampFiat": "<string>",
"paymentListFrom": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
],
"paymentListTo": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
]
}
}使用 GET
/v2/base/fiat/payments 接口获取法币到法币全球支付通道可用的支付方式。通过查询参数提供付款方（入金）和收款方（出金）的国家及币种。响应返回两份独立的支付方式列表——一份用于付款端，一份用于收款端——每项都包含对应的手续费和处理类型。利用这些数据，可以在跨境支付的两端展示正确的支付通道。
请求
GET /v2/base/fiat/payments
请求头
| 请求头 | 值 | 必填 |
|---|---|---|
X-BH-TOKEN | 通过 GET /v2/token/generate 获取的令牌 | ✓ |
查询参数
string
必填
付款方国家名称（例如
"Mexico"）。string
必填
付款方法币的 ISO 4217 代码（例如
"MXN"）。string
必填
收款方国家名称（例如
"Argentina"）。string
必填
收款方法币的 ISO 4217 代码（例如
"ARS"）。响应字段
number
HTTP 风格的状态码。
200 表示成功。string
可读的状态信息，例如
"SUCCESS"。object
包含回显的支付通道及其两端支付方式的对象。
显示 data
显示 data
string
从请求中回显的付款方国家。
string
从请求中回显的付款方法币代码。
string
从请求中回显的收款方国家。
string
从请求中回显的收款方法币代码。
array
示例
cURL
curl --request GET \
--url 'https://api.velafi.com/v2/base/fiat/payments?onRampCountry=Mexico&onRampFiat=MXN&offRampCountry=Argentina&offRampFiat=ARS' \
--header 'X-BH-TOKEN: YOUR_TOKEN'
响应
{
"code": 200,
"msg": "SUCCESS",
"data": {
"onRampCountry": "Mexico",
"onRampFiat": "MXN",
"offRampCountry": "Argentina",
"offRampFiat": "ARS",
"paymentListFrom": [
{
"paymentId": 1,
"fiatFee": "2",
"paymentType": 1
},
{
"paymentId": 2,
"fiatFee": "1.50",
"paymentType": 0
}
],
"paymentListTo": [
{
"paymentId": 1,
"fiatFee": "2",
"paymentType": 1
},
{
"paymentId": 3,
"fiatFee": "1.75",
"paymentType": 0
}
]
}
}
由于付款通道和收款通道相互独立运行，
paymentListFrom 和 paymentListTo 可能包含不同的支付方式和手续费。请向用户同时展示两份列表，并在创建支付订单前分别为每一端收集所选的 paymentId。⌘I
获取法币→法币支付方式
curl --request GET \
--url https://api-test.velafi.com/v2/base/fiat/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/fiat/payments"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/base/fiat/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/base/fiat/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"onRampCountry": "<string>",
"onRampFiat": "<string>",
"offRampCountry": "<string>",
"offRampFiat": "<string>",
"paymentListFrom": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
],
"paymentListTo": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123
}
]
}
}