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:
| 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. | —- |
| Cartão | Carteiras digitais | Somente é possível adicionar cartões nas Carteiras digitais em ambiente de produção. | —- |
| Cartão | Autenticação 3DS | Criaçã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ão | Evento de embossing | O evento CARD_WAS_EMBOSSED é disparado apenas em produção. | —- |
| Pix (DICT) | Portabilidade e reinvindicação de chaves | Reconhecimento 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. |
| Fatura | Fluxo completo | Todo o fluxo de gestão de faturas ocorre apenas em ambiente de produção. | |
| TED | Processo de devolução | O evento TED_REFUND_WAS_CLEARED é disparado apenas em produção. | —- |
| Pagamento de contas | Processo de pagamento de contas | O 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 eventos | Consulta de eventos de cartão por proxy | Em 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:
| Descrição | URL Sandbox | URL Produção |
|---|---|---|
| URL de autenticação na API para obter o token para o certificado mTLS | https://login.sandbox.bankly.com.br/connect/token/ | https://login.bankly.com.br/connect/token/ |
| URL para download do certificado | https://api.sandbox.bankly.com.br/partners/{companyKey}/certificates/ | https://api.bankly.com.br/partners/{companyKey}/certificates/ |
| Registro dinâmico de client | https://auth-mtls.sandbox.bankly.com.br/oauth2/register/ | https://auth.bankly.com.br/oauth2/register/ |
| Geração de token | https://auth-mtls.sandbox.bankly.com.br/oauth2/token/ | https://auth.bankly.com.br/oauth2/token/ |
| Demais endpoints | https://api-mtls.sandbox.bankly.com.br/ | https://api-mtls.bankly.com.br/ |
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.
Updated about 2 months ago