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 Bankly 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 e performático que o de sandbox.

🚧

Importante

É essencial que os desenvolvedores do parceiro utilizem o ambiente de sandbox para se integrar conforme as orientações do time de TAM (Technical Account Manager) 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

Alguns produtos do Bankly apresentam jornadas que não podem ser testadas por completo em ambiente de sandbox, pois algumas etapas dependem de fluxos externos que não podem ser simulados.

Confira a seguir os contextos que apresentam limitações para testes em sandbox:

ContextoEtapa do fluxoLimitaçãoAlternativa
AutorizaçãoEventos de autorização e confirmaçãoOs eventos do contexto de Autorização são disparados apenas no ambiente de produção.—-
CartãoCarteiras digitaisSomente é possível adicionar cartões nas Carteiras digitais em ambiente de produção.—-
CartãoAutenticação 3DSCriação do desafio (challengeId) para a autenticação 3DS.Endpoint de Simulação de criação do desafio (challengeId), que funciona apenas em sandbox. Em produção, cada vez que for gerado um desafio, será disparado automaticamente o evento de webhook PRE_AUTHENTICATION_CHALLENGE_WAS_REQUESTED, com as informações necessárias para a confirmação.
CartãoEvento de embossingO evento CARD_WAS_EMBOSSED é disparado apenas em produção.—-
Pix (DICT)Portabilidade e reinvindicação de chavesReconhecimento de pedido de reivindicação pela instituição financeira detentora da chave.Endpoint de Simulação de reconhecimento de pedido de reivindicação, que funciona apenas em sandbox. Em produção, o reconhecimento do pedido é comunicado automaticamente por meio do evento de webhook PIX_CLAIM_WAS_ACKNOWLEDGED.
FaturaFluxo completoTodo o fluxo de gestão de faturas ocorre apenas em ambiente de produção.
TEDProcesso de devoluçãoO evento TED_REFUND_WAS_CLEARED é disparado apenas em produção.—-
Pagamento de contasProcesso de pagamento de contasO processo de pagamento de contas (validação do título e confirmação do pagamento) somente pode ocorrer em ambiente de produção.Solicitar ao time de TAM uma massa de testes (boletos habilitados) para simular o pagamento.
Consulta de eventosConsulta de eventos de cartão por proxyEm sandbox a consulta de eventos por proxy não retornará eventos, visto que nesse ambiente não ocorrem movimentações reais com cartão.---

🚧

Importante

Nos casos de impossibilidade de testes, o parceiro deverá considerar que a documentação do Bankly 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 Bankly antes de subirem sua aplicação para produção.

Atenção

Mesmo após homologadas, todas as novas features a serem integradas devem ser validadas pelo time de TAM, para que sejam liberados os escopos e 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.

Confira a seguir as URLs correspondentes a cada ambiente:

🚧

Importante

O Bankly se esforça para manter a similaridade entre os ambientes de produção e sandbox, embora haja ocasiões em que isso não é viável. Em situações excepcionais, caso ocorra alguma discrepância entre os ambientes, a documentação adotará o ambiente de produção como referência para assegurar a integração adequada ao produto.

Para mais informações sobre o processo de homologação e o ambiente de produção, contate o time de TAM.


Copyright © 2021 Acesso Soluções de Pagamento S.A - Todos os direitos reservados