Sandbox
El ambiente de sandbox de BTG PACTUAL EMPRESAS cuenta con todos los endpoints existentes en la API de producción, pero todas las responses son predeterminadas y estáticas. El ambiente también se encuentra conectado a un servidor de autenticación dedicado a su funcionamiento.
| URI APIs | URI BTG Id |
|---|---|
| https://api.sandbox.empresas.btgpactual.com | https://id.sandbox.btgpactual.com |
Propósito
El ambiente de sandbox fue concebido con su papel principal en la validación de los contratos de las APIs y la validación del flujo de generación de token. Por lo tanto, el ambiente es mockeado, o, en otras palabras, el ambiente tiene sus retornos estáticos, validando los contratos y retornando, en caso de éxito, respuestas fieles al ambiente productivo.
Las cobranzas, pagos y demás entidades no se crean ni se almacenan efectivamente, así como no hay conexión entre el ambiente de sandbox y el ambiente de producción. Esto ofrece seguridad al no exponer tus datos de ninguna manera y ofrece una estabilidad sin igual.
¿Cuándo debo usar el sandbox?
- Cuando quiero verificar el comportamiento de los flujos de autorización y autenticación por estar conectado a un servidor de autenticación BTG Id exclusivo;
- Cuando quiero probar el contrato de las APIs sin exponer datos sensibles en las fases iniciales de desarrollo.
¿Cuándo no debo usar el sandbox?
- Cuando quiero probar webhooks;
- Cuando quiero probar los contratos con datos reales;
- Cuando quiero realizar un stress test.
Token y solicitudes
Los tokens generados en el ambiente de sandbox permiten que el consentimiento se otorgue únicamente para la empresa dedicada al funcionamiento del ambiente.
Por lo tanto, el companyId, el accountId y las demás claims del token derivarán de esta empresa. En este caso, la empresa es 30306294000145 y este valor:
- Sustituirá el CNPJ de tu empresa cuando sea necesario el companyId;
- Formará parte del accountId obtenido en el endpoint de listado de cuentas;
- Constará en las claims de tu token en lugar del CNPJ de cualquier otra empresa (al pegar el token en el sitio jwt.io verás las claims).