配置
获取法币→法币支付方式
获取法币到法币全球支付通道的支付方式,分别返回付款币种和收款币种的支付方式列表。
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 获取的令牌 | ✓ |
查询参数
响应字段
包含回显的支付通道及其两端支付方式的对象。
显示 data
显示 data
示例
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
}
]
}
}