Saltar al contenido principal

Introducción

La Merchant API de Volet.com permite que tu aplicación acepte pagos cripto, envíe pagos y transferencias, haga seguimiento de transacciones y consulte datos de la cuenta, como saldos, tarifas y límites.

Para escenarios paso a paso, consulta las guías: Integración por API para aceptar pagos e Integración por API para pagos masivos.

URL base​

https://api.volet.com

Todos los endpoints son relativos a esta URL, por ejemplo https://api.volet.com/api/account/balances.

Antes de empezar​

  • Una cuenta de Volet.com verificada, personal o Business.
  • Una API creada en la sección de herramientas de pago de tu cuenta, con los permisos que necesita tu integración. Consulta Crear una pasarela de pago o Activar los pagos masivos.
  • Las direcciones IP de tus servidores en la lista blanca de IP de la API.

Volet.com no ofrece un sandbox. Prueba tu integración con transacciones reales pequeñas.

Autenticación​

Cada solicitud incluye tres encabezados:

EncabezadoValor
Api-NameEl nombre de la API en tu cuenta de Volet.com
Account-EmailEl email de la cuenta de Volet.com a la que pertenece la API
Authentication-TokenUn token SHA-256 generado a partir de la contraseña de la API y la fecha y la hora actuales en UTC

Generar el token de autenticación​

  1. Arma la cadena password:YYYYMMDD:HH, donde password es la contraseña de tu API, y la fecha y la hora están en UTC.
  2. Calcula el hash SHA-256 de la cadena.
  3. Envía el hash como cadena hexadecimal en el encabezado Authentication-Token. La API no distingue mayúsculas de minúsculas; lo habitual es usar minúsculas.

Por ejemplo, para la contraseña MySecret123 a las 14:00 UTC del 26 de octubre de 2026:

SHA256("MySecret123:20261026:14")

da como resultado:

c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd

El token cambia cada hora UTC. Genéralo justo antes de cada solicitud. La API también acepta los tokens de la hora anterior y de la siguiente, así que no rechaza una solicitud enviada en el cambio de hora o desde un servidor con el reloj ligeramente desajustado.

En el panel Try it de cada método puedes ingresar la contraseña de la API y generar el token en tu navegador. La contraseña no se envía a ningún lado.

Guarda la contraseña en tu servidor

A la API solo se envía el token, nunca la contraseña. No pongas la contraseña de la API ni los tokens en código frontend, apps móviles, bots ni otros scripts del lado del cliente.

Formato de las solicitudes​

  • Las solicitudes y respuestas usan JSON sobre HTTPS. Envía Content-Type: application/json con el cuerpo de la solicitud.
  • Los montos son números decimales, por ejemplo "amount": 100. La API también los acepta como cadenas, como "amount": "100.00". La cantidad de decimales depende de la moneda.
  • Los códigos de las stablecoins incluyen la red donde los fondos se mueven en una blockchain, por ejemplo USDT_TRC20; las monedas de las billeteras van sin red, como USDT. Consulta Códigos de moneda y montos.

Ejemplo de solicitud:

curl https://api.volet.com/api/account/balances \
-H "Api-Name: my-api" \
-H "Account-Email: [email protected]" \
-H "Authentication-Token: c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd"

Límite de solicitudes​

Para las cuentas personales y las cuentas de empresa que no completaron la verificación, la API limita la cantidad de solicitudes por hora. Cuando se agota el límite, la API devuelve HTTP 401 con el error attemptsHaveEndedException. Espera y envía la solicitud más tarde. Las cuentas de empresa verificadas no tienen este límite por hora.