Configuration
List Crypto→Fiat Payment Methods
Retrieve the available payment methods for a crypto-to-fiat off-ramp pair, including fees and whether each method is automatic or manual.
GET
/
v2
/
base
/
sell
/
payments
List Crypto→Fiat Payment Methods
curl --request GET \
--url https://api-test.velafi.com/v2/base/sell/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/sell/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/sell/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/sell/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/sell/payments endpoint to retrieve the payment methods available for a specific crypto-to-fiat off-ramp pair. Pass the destination country, fiat currency, and source cryptocurrency as query parameters. The response lists each eligible payment method along with its fee and processing type, giving you everything you need to present off-ramp payout options to your users before they submit a sell order.
Request
GET /v2/base/sell/payments
Headers
| Header | Value | Required |
|---|---|---|
X-BH-TOKEN | Your token from GET /v2/token/generate | ✓ |
Query Parameters
string
required
Name of the destination country associated with the fiat currency (e.g.,
"Mexico").string
required
ISO 4217 code for the destination fiat currency (e.g.,
"MXN").string
required
Ticker symbol for the source 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/sell/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 settle without manual intervention. paymentType: 0 (manual) methods require human review and may take longer to complete.Was this page helpful?
⌘I
List Crypto→Fiat Payment Methods
curl --request GET \
--url https://api-test.velafi.com/v2/base/sell/payments \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/base/sell/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/sell/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/sell/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>"
}
]
}
}