Saltar al contenido principal
Generar un token
Usa este endpoint para obtener un token de negocio. Tu servidor firma la solicitud con su secreto de API y envía su clave de API en el header X-BH-APIKEY. La respuesta contiene un token, que envías en el header X-BH-TOKEN en las solicitudes autenticadas, y un expireTime.
Para que esta llamada funcione, VelaFi debe habilitar el acceso a la API en tu cuenta y la clave de API debe tener una lista blanca de IP. La solicitud debe provenir de una dirección IP incluida en esa lista blanca. Consulta Autenticación.

Endpoint

Usa https://api-test.velafi.com/v2/token/generate con tus credenciales de sandbox para hacer pruebas en sandbox.

Headers de la solicitud

string
requerido
Tu clave de API.

Parámetros de consulta

integer
requerido
La hora Unix actual en milisegundos, por ejemplo 1740568725231.
string
requerido
HMAC-SHA256 de la cadena timestamp=<timestamp>, con tu secreto de API como clave y codificado en hexadecimal en minúsculas.
Envía solo timestamp y signature como parámetros de consulta. El servidor verifica la firma contra tu query string sin el parámetro signature. Con solo estos dos parámetros, la cadena firmada es exactamente timestamp=<timestamp>.

Cómo firmar

1

Construye el mensaje

Toma la hora Unix actual en milisegundos y construye la cadena timestamp=<ms>, por ejemplo timestamp=1740568725231.
2

Calcula el HMAC

Calcula el HMAC-SHA256 del mensaje usando tu secreto de API como clave.
3

Codifica el resultado en hexadecimal

Codifica el resultado de 32 bytes como una cadena hexadecimal en minúsculas de 64 caracteres. Esta es la signature.

Campos de la respuesta

integer
200 si la solicitud es exitosa. Los errores devuelven un código negativo; consulta Errores.
string
SUCCESS si la solicitud es exitosa; de lo contrario, un mensaje de error.
object

Ejemplos

Response

Errores

Los errores devuelven el estado HTTP 400 con un code negativo:

Usar el token

Envía el token en el header X-BH-TOKEN:
Solicita un token nuevo antes de expireTime. Una llamada con un token vencido o desconocido falla con el código -1022.