Comercios
Obtener la comisión de transferencia
Consulta la comisión aplicable a transferencias entre comercios para una moneda fiat antes de iniciar una transferencia de Pending Fund: modelo fijo o porcentual.
GET
/
v2
/
merchant
/
transfer_fee
Obtener la comisión de transferencia
curl --request GET \
--url https://api-test.velafi.com/v2/merchant/transfer_fee \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/merchant/transfer_fee"
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/merchant/transfer_fee', 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/merchant/transfer_fee")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"fiat": "<string>",
"feeType": 123,
"fee": 123
}
}Usa este endpoint para obtener la comisión aplicable antes de transferir fondos entre cuentas de comercio. VelaFi admite dos modelos de comisión: una comisión fija y una comisión porcentual. Consulta la comisión antes de llamar a Transferir Pending Funds para que puedas mostrar a tus usuarios información de costos precisa.
Todas las solicitudes deben incluir el header
X-BH-TOKEN con un token de negocio obtenido de GET /v2/token/generate. Actualmente las monedas admitidas son MXN y ARS.Endpoint
GET https://api.velafi.com/v2/merchant/transfer_fee
Parámetros de consulta
string
requerido
Moneda fiat para la que se consulta la comisión de transferencia. Valores admitidos:
MXN, ARS.Campos de la respuesta
number
Código de respuesta de estilo HTTP.
200 indica éxito.string
Mensaje de estado legible, por ejemplo
SUCCESS.object
Mostrar campos de data
Mostrar campos de data
string
La moneda fiat a la que se aplica la comisión.
number
Modelo de comisión:
0 = comisión fija, 1 = comisión porcentual.number
Valor de la comisión. Para comisiones porcentuales (
feeType=1), es un decimal entre 0 y 1 (por ejemplo, 0.01 = 1%). Para comisiones fijas (feeType=0), es un monto fijo en la moneda.Ejemplos
- Comisión porcentual
- Comisión fija
cURL
curl -G https://api.velafi.com/v2/merchant/transfer_fee \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "fiat=MXN"
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"fiat": "MXN",
"feeType": 1,
"fee": 0.01
}
}
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"fiat": "MXN",
"feeType": 0,
"fee": 5
}
}
Cuando
feeType es 1 (porcentual), multiplica fee por el monto de la transferencia para calcular el costo. Por ejemplo, un fee de 0.01 sobre una transferencia de 1,000 MXN equivale a una comisión de 10 MXN.⌘I
Obtener la comisión de transferencia
curl --request GET \
--url https://api-test.velafi.com/v2/merchant/transfer_fee \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/merchant/transfer_fee"
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/merchant/transfer_fee', 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/merchant/transfer_fee")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"fiat": "<string>",
"feeType": 123,
"fee": 123
}
}