Skip to main content
El repositorio incluye una colección Postman lista para importar con todos los endpoints de la Business API, carpetas por módulo (Payins, Payouts, Exchange, Transactions, Users, Webhooks) y ejemplos de request body.

​
Importar la colección

1

Descarga el archivo

En el repositorio: Business_API.postman_collection.json.
2

Impórtalo en Postman

En Postman: File → Import → arrastra el .json o selecciónalo del disco. La colección aparecerá en tu workspace como “Business API”.
3

Crea un Environment

Crea un environment nuevo (ej. “Vita Sandbox”) y declara las variables que la colección referencia. Como mínimo:
4

Selecciona el environment

En el selector superior derecho de Postman, elige el environment recién creado antes de ejecutar un request.
No pushees tu environment de Postman al repo — contiene credenciales. Exporta solo la colección (sin variables resueltas) si necesitas compartir.

​
Firma automática

La colección incluye un pre-request script que calcula la firma HMAC-SHA256 de cada petición y la inyecta en el header Authorization. Para que funcione:
  • Todas las variables de arriba deben estar definidas en el environment.
  • El reloj de tu máquina debe estar sincronizado (NTP). La firma incluye x-date y Vita rechaza requests con desfase > 1 minuto.
Si recibes 422 Invalid signature:
Ejecuta date en tu terminal y compara con la hora real. Activa sincronización NTP del SO.
Confirma que estás usando el environment Sandbox con credenciales Sandbox (no mezcles con producción).
No agregues campos al body manualmente después de disparar el request — el pre-request script firma el body original.

​
Variables adicionales recomendadas

Para flujos que encadenan varios requests (ej. crear payment order → consultar attempt), guarda IDs en variables del environment con Tests scripts de Postman:
Los siguientes requests pueden usar {{payment_order_id}} en la URL.

​
OpenAPI alternativo

Si prefieres OpenAPI sobre Postman, usa openapi.yaml del mismo repo. Es la fuente de la API Reference de esta documentación y se puede importar en cualquier cliente compatible (Insomnia, Bruno, hey, HTTPie Desktop, etc.).