Erro CBE098 na API de Pagamento de Contas (BaaS)

O que significa o erro CBE098?

O erro "errorCode": "CBE098" "errorMessage": "Não foi localizado um agente de saque AGTEC para esse usuário" pode ocorrer ao utilizar a API de Pagamento de Contas (fluxo de bill payments) do BaaS no ambiente sandbox.

Na prática, esse erro indica uma falha na simulação do “agente de saque AGTEC” para o usuário no ambiente de testes. Entretanto, na maioria dos casos, ele está relacionado à falta de saldo na conta utilizada no sandbox.

Em que contexto esse erro ocorre?

O erro costuma aparecer durante chamadas da API de Pagamento de Contas em ambiente de sandbox, quando a conta usada na requisição não possui saldo suficiente para realizar o pagamento.

Como o sandbox é um ambiente de testes, o saldo das contas não é abastecido por transações reais (como Pix, boletos ou TED). Por isso, é necessário adicionar saldo manualmente antes de realizar operações financeiras.

Esse erro ocorre em produção?

Não. No ambiente de produção, o saldo das contas BaaS é abastecido por operações reais de cash-in (como Pix, boletos e TED). O endpoint de Adicionar saldo existe apenas no sandbox e não está disponível em produção.

Como resolver o erro no sandbox

1. Verifique o saldo da conta utilizada no pagamento de contas
   (usando os endpoints de saldo ou extrato do BaaS, se disponíveis).

2. Adicione saldo na conta de sandbox utilizando o endpoint de Adicionar saldo (Gerar Lançamento).

3. Refaça a requisição de pagamento de contas após o crédito do valor.

E se eu não conseguir adicionar saldo?

Caso não seja possível utilizar o endpoint de Adicionar saldo em sandbox, ou se o erro continuar mesmo após creditar valores na conta, recomenda-se abrir um chamado no suporte técnico ou entrar em contato com o analista de onboarding.

Ao abrir o chamado, informe:

• informar que o erro ocorre na API de Pagamento de Contas do BaaS;

• o código e mensagem de erro: CBE098 – Não foi localizado um agente de saque AGTEC para esse usuário;

• o ambiente utilizado (sandbox);

• dados básicos da requisição, como conta, valor e horário aproximado da tentativa.

Para mais informações acesse a nossa documentação.