Tema
Entornos
Hay dos, y son instalaciones separadas: bases distintas, llaves distintas, dinero distinto.
| URL base | |
|---|---|
| Sandbox | https://sanbox-exchange-back.vectrakpital.com |
| Producción | https://back.vectrakpital.com |
Los endpoints, las validaciones y los códigos de error son los mismos. No es una maqueta ni un subconjunto: es el mismo servicio con el mercado apagado, así que el flujo que ejercitas en sandbox es el flujo que va a correr contra un mercado real.
La forma más cómoda de trabajar con los dos es no escribir la URL en ningún sitio:
bash
export VECTRAKPITAL_API=https://sanbox-exchange-back.vectrakpital.com
export VECTRAKPITAL_KEY=vk_live_3f9a1c72b40de5a1.hR8xK2mQ...Pasar a producción es entonces cambiar una variable, no buscar y reemplazar en tu código.
Una llave no cruza de entorno
Se emiten por separado, desde el portal de cada entorno, y viven en bases distintas. Una llave de sandbox contra producción responde 401, igual que una inventada — todo fallo de autenticación responde igual, así que el 401 no te va a decir que te equivocaste de entorno. Si una llave que sabes buena deja de funcionar, comprueba contra qué URL la estás mandando antes de suponer que la revocaron.
Qué es de verdad en sandbox y qué no
Lo que se comporta igual: los permisos y su intersección con el puesto, las retenciones de saldo, las ventanas de vencimiento de una cotización, los límites de la organización, el libro mayor y la aprobación humana de cada cambio y cada retiro.
Lo que no:
Las direcciones de depósito son de juguete
TSandbox000000000000000000000000000 no es una dirección de la red TRON. Nada enviado ahí llega a ningún sitio y no hay forma de recuperarlo. En sandbox, un depósito se simula; no se transfiere.
Nada llega nunca a un mercado. La ejecución está apagada, y no por una preferencia que alguien pueda cambiar sin darse cuenta: la configuración se niega a arrancar si el mercado simulado se combina con cualquiera de las banderas de ejecución. Ejecutar de verdad mientras el único control que podría notar una divergencia está apagado no es un estado en el que nadie quisiera estar.
Los precios salen de la referencia pública de tipo de cambio, no del libro de un mercado. Son plausibles y se mueven, pero no son ejecutables: no hay nadie al otro lado. Un precio de sandbox no sirve para estimar lo que te costaría una operación real.
La conciliación siempre cuadra, y por eso no detecta nada
El mercado simulado responde con el propio libro mayor, así que las dos cifras que la conciliación compara vienen de la misma fuente y coinciden por construcción. Un verde en sandbox no es evidencia de que tu integración no produciría un descuadre en producción — es evidencia de que nada lo estaba buscando.
Cómo pasar a producción
- Emite una llave nueva desde el portal de producción. La de sandbox no sirve, y reutilizarla no es una opción disponible aunque quisieras.
- Cambia
VECTRAKPITAL_API. - Vuelve a leer los decimales. Son por activo y los devuelve la respuesta, así que en principio son los mismos — pero si en algún momento los fijaste en tu código «porque en sandbox siempre eran 4», este es el momento en que eso te cuesta dinero. Ver el modelo de montos.
- Empieza por un monto que no te importe perder. La primera operación real es el peor sitio para descubrir un error de factor mil.