Configuration
List Fiat→Crypto Payment Methods
Retrieve the available payment methods for a fiat-to-crypto on-ramp pair, including fees and whether each method is automatic or manual.
GET
/
v2
/
base
/
buy
/
payments
List Fiat→Crypto Payment Methods
curl --request GET \
--url https://api-test.velafi.com/v2/base/buy/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/buy/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/buy/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/buy/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"country": "<string>",
"fiat": "<string>",
"crypto": "<string>",
"paymentList": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123,
"trench": "<string>"
}
]
}
}Use the GET
/v2/base/buy/payments endpoint to retrieve the payment methods available for a specific fiat-to-crypto on-ramp pair. Pass the target country, fiat currency, and cryptocurrency as query parameters. The response lists every eligible payment method together with its fee and processing type — automatic or manual — so you can present the right options to your users before they initiate a purchase.
Request
GET /v2/base/buy/payments
Headers
| Header | Value | Required |
|---|---|---|
X-BH-TOKEN | Your token from GET /v2/token/generate | ✓ |
Query Parameters
string
required
Name of the country associated with the fiat currency (e.g.,
"Mexico").string
required
ISO 4217 code for the fiat currency (e.g.,
"MXN").string
required
Ticker symbol for the target cryptocurrency (e.g.,
"USDT").Response Fields
number
HTTP-style status code.
200 indicates success.string
Human-readable status message, e.g.
"SUCCESS".object
Object containing the echoed pair and its supported payment methods.
Show data
Show data
string
Country name echoed from the request.
string
Fiat currency code echoed from the request.
string
Cryptocurrency symbol echoed from the request.
array
List of payment method objects available for this pair.
Example
cURL
curl --request GET \
--url 'https://api.velafi.com/v2/base/buy/payments?country=Mexico&fiat=MXN&crypto=USDT' \
--header 'X-BH-TOKEN: YOUR_TOKEN'
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"country": "Mexico",
"fiat": "MXN",
"crypto": "USDT",
"paymentList": [
{
"paymentId": 72,
"fiatFee": "0",
"paymentType": 1,
"trench": "CLABE - TESORED"
},
{
"paymentId": 105,
"fiatFee": "0",
"paymentType": 1,
"trench": "CLABE - FINCO PAY"
}
]
}
}
paymentType: 1 (automatic) methods complete without manual intervention. paymentType: 0 (manual) methods require human review and may take longer to process.Was this page helpful?
⌘I
List Fiat→Crypto Payment Methods
curl --request GET \
--url https://api-test.velafi.com/v2/base/buy/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/buy/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/buy/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/buy/payments")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"country": "<string>",
"fiat": "<string>",
"crypto": "<string>",
"paymentList": [
{
"paymentId": 123,
"fiatFee": "<string>",
"paymentType": 123,
"trench": "<string>"
}
]
}
}