Ambiente de Sandbox X Produção
Sandbox e produção são termos utilizados para designar dois tipos de ambientes de desenvolvimento de software que possuem finalidades distintas.
Ambiente de sandbox
O ambiente de sandbox, também conhecido como ambiente de teste ou de homologação, é uma simulação do ambiente de produção que permite aos desenvolvedores testarem e validarem suas aplicações sem afetar o ambiente real.
Os dados utilizados em sandbox são fictícios e, portanto, não causam nenhum impacto em operações ou transações verdadeiras.
É um ambiente seguro para testes, que permite aos desenvolvedores do parceiro Hiperbanco realizarem simulações e ajustes necessários antes de disponibilizarem a aplicação em ambiente de produção.
Entretanto, apesar de o ambiente de sandbox ser uma réplica do ambiente de produção, esses ambientes não devem ser comparados em questão de performance, pois o ambiente de produção é muito mais rápido, performático e estável que o de sandbox.
ImportanteÉ essencial que os desenvolvedores do parceiro utilizem o ambiente de sandbox para integrar a nossa API, conforme orientações do time de Clientes e os requisitos de implantação para homologação.
Além disso, é fundamental testar suas aplicações antes de disponibilizá-las em ambiente de produção, garantindo, assim, um melhor desempenho, estabilidade e segurança do sistema.
Limitações do ambiente de sandbox
Determinados produtos do Hiperbanco possuem jornadas que não podem ser validadas integralmente em ambiente de sandbox, uma vez que determinadas etapas estão vinculadas a fluxos externos que não podem ser reproduzidos ou simulados nesse contexto.
Confira a seguir os contextos que apresentam limitações para testes em sandbox:
| Contexto | Etapa do fluxo | Limitação | Alternativa |
|---|---|---|---|
| Autorização | Eventos de autorização e confirmação | Os eventos do contexto de Autorização são disparados apenas no ambiente de produção. | Cliente simular o envio do webhook através do endpoint cadastrado para aquele webhook |
| Cartão | Evento de embossing | O evento CARD_WAS_EMBOSSED é disparado apenas em produção. | Cliente simular o envio do webhook através do endpoint cadastrado para aquele webhook |
| TED | Processo de devolução | O evento TED_REFUND_WAS_CLEARED é disparado apenas em produção. | Cliente simular o envio do webhook através do endpoint cadastrado para aquele webhook |
| Pagamento de contas | Processo de pagamento de contas | O processo (validação e confirmação) só ocorre em produção. | Solicitar ao time de clientes uma massa de testes (boletos habilitados) para simular o pagamento. |
| Consulta de eventos | Consulta de eventos de cartão por proxy | Em sandbox, a consulta não retornará eventos, pois não há movimentações reais com cartão. | — |
ImportanteNos casos de impossibilidade de testes, o parceiro deverá considerar que a documentação do Hiperbanco reflete o ambiente de produção.
Ambiente de produção
O ambiente de produção é o local onde as aplicações e sistemas do parceiro rodam utilizando dados reais.
É nesse ambiente em que ocorrem as operações e transações reais, realizadas pelos usuários finais. Portanto, é de imprescindível que os parceiros atendam a todos os requisitos de homologação do Hiperbanco antes de subirem sua aplicação para produção.
AtençãoMesmo após homologadas, todas as novas features a serem integradas devem ser validadas pelo time de integrações do Hiperbanco para garantir que a implantação tenha ocorrido da melhor forma possível, evitando erros de requisição ou equívocos sobre algum aspecto do produto durante uso em produção.
URLs de sandbox e produção
As URLs disponibilizadas na documentação, Manual do Dev e APIs, devem ser utilizadas para testes, no ambiente de sandbox. Somente após o processo de homologação, o parceiro poderá ter acesso ao ambiente de produção.
Updated 22 days ago