No ambiente de sandbox da Celcoin é possível configurar algumas travas (regras de validação) que ajudam a simular comportamentos mais próximos do ambiente de produção. Essas configurações não são realizadas diretamente via API; o ajuste é feito internamente pela equipe da Celcoin mediante solicitação ao analista de Onboarding responsável pela integração ou por meio de um chamado ao suporte técnico.
É possível testar transferências Pix entre contas da própria Celcoin no sandbox?
Uma das travas disponíveis define se o ambiente permite transações Pix somente entre instituições diferentes. Quando essa regra está habilitada, o sandbox permite realizar Pix apenas entre contas de instituições distintas, como por exemplo uma conta da Celcoin enviando para outro banco. Quando está desabilitada, também é possível realizar transferências entre contas da própria Celcoin dentro do ambiente de testes, o que costuma ser útil para validar todo o fluxo de ponta a ponta usando apenas o sandbox.
O sandbox permite criar várias contas usando o mesmo CPF ou CNPJ?
Essa configuração controla se é possível criar mais de uma conta utilizando o mesmo CPF ou CNPJ. Ao habilitar essa trava, o ambiente passa a restringir a criação de múltiplas contas com o mesmo documento, simulando cenários semelhantes ao ambiente de produção, onde o CPF ou CNPJ normalmente funciona como identificador único do usuário. Caso esteja desabilitada, o sandbox permite a criação de várias contas com o mesmo documento para facilitar testes.
Posso reutilizar o mesmo e-mail ou telefone em diferentes cadastros de conta?
Existe uma regra que define se um mesmo endereço de e-mail pode ser utilizado em mais de um cadastro de conta. Quando a restrição está ativa, cada conta precisa ter um e-mail exclusivo. Quando está desativada, o mesmo e-mail pode ser reutilizado em diferentes contas dentro do sandbox, o que pode ajudar em cenários de teste mais flexíveis.
De forma semelhante, é possível controlar se um mesmo número de telefone pode ser utilizado em múltiplos cadastros. Essa configuração permite simular políticas de unicidade de telefone que podem existir no produto final, garantindo que cada conta possua um número exclusivo quando a trava estiver habilitada.
É permitido cadastrar mais de um webhook para o mesmo tipo de evento?
Sim, há uma parametrização que controla se é possível registrar múltiplos endpoints para o mesmo evento (como um Pix recebido). Isso é especialmente útil se você precisar que diferentes ambientes, como desenvolvimento e staging, recebam as mesmas notificações simultaneamente.
Quais tipos de chaves Pix podem ser testadas no sandbox?
O ambiente também permite definir se será aceito o cadastro de diferentes tipos de chaves Pix nas contas do sandbox, incluindo chave aleatória (EVP), telefone, e-mail, CPF e CNPJ. Essa configuração possibilita simular cenários variados de registro e utilização de chaves Pix durante os testes de integração.
Como funcionam as travas de "mesma titularidade" para transações?
Outra trava disponível controla se as transações de cash-out via Pix (envio de dinheiro) devem ocorrer apenas entre contas de mesma titularidade. Quando essa regra está ativa, o envio só é permitido se o titular da conta de origem for o mesmo da conta de destino. Essa configuração pode ser usada para testar políticas internas que restringem transferências apenas entre contas do mesmo usuário.
Por fim, também é possível definir se as transações de cash-in via Pix (recebimento de dinheiro) devem ocorrer apenas entre contas de mesma titularidade. Quando habilitada, o recebimento só será aceito se o pagador e o titular da conta que recebe forem a mesma pessoa. Essa regra ajuda a simular cenários em que o produto permite recebimentos apenas entre contas pertencentes ao mesmo titular.
Caso seja necessário habilitar ou desabilitar qualquer uma dessas travas no ambiente de sandbox, basta solicitar o ajuste ao analista de Onboarding responsável pela integração ou abrir um chamado junto ao suporte técnico da Celcoin, informando claramente quais regras devem ser configuradas.
Comentários
0 comentário
Artigo fechado para comentários.