O desafio
Um checkout externo precisa manter o vínculo com a compra original para que a loja reconheça corretamente o pagamento recebido.
Este projeto explora a integração de uma loja Botble com o checkout hospedado da InfinitePay. A loja organiza a compra e solicita um link; o cliente realiza a etapa de pagamento na página do provedor. Depois, a integração precisa reconciliar o resultado com o pedido que originou a cobrança.
O módulo foi estruturado para preservar essa ligação durante a saída e o retorno do comprador. O código inclui criação do link, referências de pedido, recepção de aviso e consulta de pagamento. A pesquisa confirmou a implementação local, mas não encontrou um teste completo de cobrança aprovada ou uma implantação pública comprovada.
Como o fluxo funciona
- 01
Organizar a compra
Os produtos e quantidades são preparados em centavos. Frete e taxas participam da totalização, mantendo a correspondência com o valor esperado pela loja.
- 02
Criar o link
O servidor envia o pedido ao serviço de checkout, com sua referência e endereços de retorno. A API deve responder com o link hospedado.
- 03
Pagar no provedor
O comprador segue para a página externa e utiliza as opções disponibilizadas pela conta e pelo checkout. Essa etapa pertence à experiência do provedor.
- 04
Conferir a transação
No retorno ou recebimento de webhook, a integração consulta o pagamento. O código usa os identificadores da transação para verificar o resultado antes da conclusão local.
- 05
Atualizar a loja
Quando a resposta informa pagamento realizado, os pedidos relacionados entram no processamento. Uma verificação evita repetir a conclusão de pedidos já pagos.
O trabalho desenvolvido
A implementação prepara os itens e valores do pedido, cria o link InfinitePay e confere a transação antes de processar os pedidos relacionados.
- Checkout hospedado pelo provedor
- Itens, frete e total vinculados ao pedido
- Verificação do pagamento no retorno
Checkout hospedado com continuidade do pedido
A principal responsabilidade da integração é manter uma referência confiável entre a compra na loja e o pagamento externo. Um simples redirecionamento de volta não basta para comprovar recebimento; por isso o fluxo implementado inclui uma consulta específica de confirmação.
A organização dos itens também importa. O código considera produtos, frete e taxas e possui uma alternativa para manter o total quando a soma detalhada não corresponde ao valor esperado. Essa regra deve ser revisada com exemplos reais na homologação.
Da implementação à operação
A presença do módulo demonstra a estrutura técnica do fluxo, sem afirmar que todas as etapas já foram aprovadas pela conta de pagamento. A próxima fase é validar credenciais, retorno, webhook, repetição de notificações e uma compra completa no ambiente adequado.
Uma proposta sob orçamento pode aproveitar essa base para integrar uma loja existente, ajustar mensagens e documentar o atendimento a pagamentos pendentes. O escopo comercial depende da compatibilidade atual da API, da conta e da versão da plataforma.
Entrega e contexto
Os serviços de criação do link, retorno, webhook e verificação estão presentes no código. A homologação financeira ainda precisa ser documentada.
O que considerar na implantação
- O comprador paga em página hospedada; não é checkout transparente de cartão dentro da loja.
- Não foi localizada comprovação de cobrança aprovada ou homologação pública deste módulo.
- Recorrência, split e estorno automático não fazem parte dos recursos demonstrados.
Perguntas frequentes
O pagamento acontece dentro do meu site?
A compra começa no site, mas o pagamento usa um link hospedado pela InfinitePay. A integração conecta o resultado ao pedido da loja.
O módulo já está disponível para instalação imediata?
O código existe e pode orientar um projeto sob orçamento. A entrega exige revisão de compatibilidade e homologação antes de entrar em operaçã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.