O desafio
A loja precisava combinar opções de pagamento com atualização consistente dos pedidos, evitando que retornos repetidos refizessem operações já concluídas.
Um checkout precisa manter a experiência do comprador alinhada ao estado financeiro do pedido. Cartão pode ser recusado, Pix pode ser pago depois e uma notificação pode chegar mais de uma vez. Este projeto tratou tanto a interface de pagamento quanto as regras que conectam essas respostas à operação da loja.
A evolução para o padrão UP partiu de uma integração existente no projeto. A versão 3.0.0 aproveita os dados brasileiros registrados no pedido, exige assinatura no webhook e reduz registros técnicos repetidos. Ela mantém Pix, cartão e boleto transparentes, além do Checkout Pro como fluxo hospedado distinto.
Como o fluxo funciona
- 01
Escolher a modalidade
O comprador seleciona uma opção habilitada pela loja. Cada modalidade segue uma preparação própria, preservando o total e a identificação dos pedidos.
- 02
Preparar o pagamento
No cartão, campos oficiais do Mercado Pago geram um token. No Pix e boleto, o servidor prepara a cobrança com prazo e informações necessárias ao método.
- 03
Solicitar a transação
A requisição usa referências do checkout e mecanismos de idempotência. A resposta pode representar pagamento aprovado, pendente ou recusado.
- 04
Conferir o retorno
O webhook exige assinatura e a conciliação compara moeda, valor, modalidade e pedidos associados. O retorno é verificado antes de alterar o registro local.
- 05
Atualizar sem repetir
Mudanças posteriores atualizam o pagamento existente. A adaptação evita repetir o ciclo inicial de estoque, mensagens e histórico apenas porque chegou outra notificação.
O trabalho desenvolvido
A versão UP organiza as modalidades, utiliza campos oficiais para cartão e confere a identidade do pagamento antes de atualizar o estado local.
- Pix, cartão e boleto transparentes
- Checkout Pro como modalidade separada
- Conciliação e registros técnicos deduplicados
Experiência de cartão com responsabilidade do provedor
Os campos de número, validade e código de segurança são montados pela integração oficial de cartão. O servidor recebe o token necessário ao pagamento. As opções de parcelamento são consultadas depois que o cartão é identificado, respeitando a configuração da loja.
A interface também recebeu tratamento de mensagens e estados. Isso torna o fluxo compreensível sem prometer aprovação: o processamento e a decisão de aceitar a transação continuam dependendo do provedor e das condições da conta.
Evolução sem tabelas próprias adicionais
A versão UP usa o pagamento nativo e os dados do snapshot do pedido brasileiro. Os registros de diagnóstico foram centralizados e deduplicados, com tratamento para consultas rotineiras e notificações repetidas, evitando registrar sucesso técnico sem necessidade.
O histórico documenta testes próprios de assinatura, transições, desconto Pix, dados cadastrais e sintaxe, além da implantação em testes. Uma suíte integrada com SQLite ficou pendente por limitação do ambiente. A homologação de cada modalidade continua necessária antes de uma entrega comercial.
Entrega e contexto
A versão 3.0.0 foi implementada e enviada a um servidor de testes, com verificações próprias aprovadas. O gateway aguardava configuração para homologação financeira.
O que considerar na implantação
- Implantação em servidor de testes não representa homologação financeira de todas as modalidades.
- Aprovação de cartão e condições de parcelamento dependem do provedor e da conta.
Perguntas frequentes
O cliente pode pagar sem sair da loja?
As modalidades transparentes foram implementadas para essa experiência. Checkout Pro é uma opção hospedada separada, com encaminhamento ao Mercado Pago.
É possível adaptar ao checkout que já utilizo?
Sim, mediante avaliação sob orçamento. O escopo depende da versão do Botble, dos módulos existentes e dos testes necessários para preservar pedidos e pagamentos.
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.