Comercios
Solicitar un aumento de límite
Envía una solicitud de aumento de límite del comercio para incrementar los topes de transacciones diarios o mensuales mediante un flujo adicional de verificación de cumplimiento.
POST
/
v2
/
upgrade
/
limits
Solicitar un aumento de límite
curl --request POST \
--url https://api-test.velafi.com/v2/upgrade/limits \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"merchantId": 123,
"callbackUrl": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/upgrade/limits"
payload = {
"merchantId": 123,
"callbackUrl": "<string>"
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({merchantId: 123, callbackUrl: '<string>'})
};
fetch('https://api-test.velafi.com/v2/upgrade/limits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/upgrade/limits")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantId\": 123,\n \"callbackUrl\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"link": "<string>"
}
}Usa este endpoint cuando las necesidades operativas de un comercio superen sus límites de transacciones actuales. Enviar esta solicitud inicia una revisión de cumplimiento reforzada en la que se le puede pedir al comercio documentación adicional, como comprobante de fondos, licencias comerciales o estados financieros auditados. Una vez aprobada, los límites diarios y mensuales del comercio se actualizan y se reflejan en la respuesta de Listar comercios.
Todas las solicitudes deben incluir el encabezado
X-BH-TOKEN y Content-Type: application/json.Endpoint
POST https://api.velafi.com/v2/upgrade/limits
Parámetros de la solicitud
number
requerido
ID del comercio que solicita el aumento de límite.
string
requerido
URL a la que VelaFi llama después de que se completa el proceso de verificación del aumento.
Campos de la respuesta
number
Código de respuesta. Este endpoint devuelve
0 cuando la solicitud es exitosa.string
Mensaje de estado.
success cuando la solicitud es exitosa.object
Mostrar Campos de data
Mostrar Campos de data
string
URL alojada que el comercio debe visitar para completar la verificación del aumento de límite.
Ejemplo
cURL
curl -X POST https://api.velafi.com/v2/upgrade/limits \
-H "X-BH-TOKEN: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"merchantId": 151209,
"callbackUrl": "https://your-app.com/limit-upgrade-callback"
}'
Respuesta
{
"code": 0,
"msg": "success",
"data": {
"link": "https://www.velafi.com/verify?velafi_token=abc123"
}
}
Da seguimiento al resultado de una solicitud de aumento de límite consultando periódicamente el campo
upgradeMerchantLimitStatus en la respuesta de Listar comercios.⌘I
Solicitar un aumento de límite
curl --request POST \
--url https://api-test.velafi.com/v2/upgrade/limits \
--header 'Content-Type: application/json' \
--header 'X-BH-TOKEN: <api-key>' \
--data '
{
"merchantId": 123,
"callbackUrl": "<string>"
}
'import requests
url = "https://api-test.velafi.com/v2/upgrade/limits"
payload = {
"merchantId": 123,
"callbackUrl": "<string>"
}
headers = {
"X-BH-TOKEN": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-BH-TOKEN': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({merchantId: 123, callbackUrl: '<string>'})
};
fetch('https://api-test.velafi.com/v2/upgrade/limits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api-test.velafi.com/v2/upgrade/limits")
.header("X-BH-TOKEN", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantId\": 123,\n \"callbackUrl\": \"<string>\"\n}")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"link": "<string>"
}
}