O desafio
A loja precisava gerar cobranças pelo Banco Inter e transformar a confirmação do banco em atualização do pedido, com uma tela clara para o comprador.
Receber Pix em uma loja envolve mais do que mostrar uma chave. A cobrança precisa corresponder ao valor do pedido, o cliente precisa saber como pagar e o sistema precisa reconhecer quando o banco confirmou o recebimento. Este projeto reuniu essas etapas em um módulo específico para Banco Inter e Botble.
O trabalho incluiu a comunicação autenticada com certificado, a criação de cobrança dinâmica e a página de pagamento pendente. A experiência foi refinada com código copia-e-cola, organização do QR e informações do pedido. Os identificadores técnicos ficaram destinados à operação, enquanto o comprador recebe instruções de pagamento.
Como o fluxo funciona
- 01
Preparar o pedido
A integração recebe o pedido, confere a moeda e prepara a cobrança com valor, identificação e prazo. O fluxo implementado trabalha com reais.
- 02
Gerar o Pix
O servidor autentica a comunicação com o banco e solicita uma cobrança dinâmica. A resposta alimenta o QR Code e o código que o comprador pode copiar.
- 03
Acompanhar o pagamento
A página consulta o estado sem precisar ser recarregada. Os intervalos aumentam ao longo do tempo e a consulta automática tem duração limitada.
- 04
Confirmar e atualizar
A consulta ao banco verifica se a cobrança foi concluída. Quando o pagamento é reconhecido, a integração atualiza os pedidos vinculados pelo fluxo nativo da loja.
O trabalho desenvolvido
Um módulo próprio reúne autenticação, criação de cobrança, QR Code, consulta de status e integração com o ciclo de pagamento do Botble.
- QR Code e Pix copia-e-cola
- Consulta progressiva com limite de duração
- Atualização do pagamento e pedido vinculados
Consulta e webhook têm papéis diferentes
O botão de conferência faz uma consulta ao banco; ele não transforma o pedido em pago apenas porque o cliente clicou. A resposta da API é que orienta a atualização. O código também contempla um webhook para receber avisos e consultar o estado correspondente.
No teste registrado no histórico, o banco criou a cobrança e depois retornou o estado concluído durante a consulta. Esse resultado comprova aquele caminho do fluxo. A entrega automática do webhook precisa ser validada separadamente, inclusive quando o cliente fecha a página.
Uma base para necessidades específicas
O módulo incorpora verificações para pedidos já concluídos e configurações de acompanhamento. As correções de interface também resolveram dependências de exibição que poderiam interromper a página depois de a cobrança já ter sido criada.
Uma nova implantação exige conferir a versão do Botble, as permissões da conta, o certificado e o comportamento dos retornos. A proposta sob orçamento pode incluir adaptação visual, homologação e documentação conforme o processo de venda do cliente.
Entrega e contexto
O histórico do projeto registra uma cobrança criada, paga e confirmada por consulta ao banco. O funcionamento automático do webhook ficou como validação separada.
O que considerar na implantação
- Este case trata de Pix em BRL; não inclui cartão ou assinatura recorrente.
- A revisão visual mais recente e o recebimento automático do webhook ainda precisam de validação final.
Perguntas frequentes
O cliente precisa clicar para o pagamento ser reconhecido?
Existe consulta automática na página e um botão de conferência. O webhook também está implementado, mas sua entrega automática deve ser homologada na instalação.
A integração pode atender outra loja Botble?
Pode ser avaliada sob orçamento. A compatibilidade, os acessos da conta e os testes completos de cobrança são definidos antes da implantação.
Um fluxo parecido na sua empresa?
Conte qual plataforma você usa, o que acontece hoje e o que precisa mudar. Com esse contexto, podemos definir o escopo, as integrações e os testes do seu projeto.
Solicitar orçamentoEscopo e investimento sob medida.