# Pix Woovi com conciliação de pedidos | Portfólio Upmy

URL: https://upmy.com.br/portfolio/modulo-pix-woovi-botble/
Language: pt-BR

Módulo customizado · Botble

## Pix Woovi com conciliação de pedidos

QR Code, ambientes separados e conferência de cobrança para uma compra com um ou mais pedidos.

[Solicitar orçamento↗](https://wa.me/5516988724774?text=Ol%C3%A1%2C%20Weliton!%20Gostaria%20de%20um%20or%C3%A7amento%20para%20Pix%20Woovi%20com%20concilia%C3%A7%C3%A3o%20de%20pedidos.)[Entender o fluxo ↗](#workflow)

Implementado · testes isolados e implantação de testes 5 etapas do fluxo Projeto sob medida 

UPMY / INTEGRATION ↗ 

01 Grupo de pedidos → 

02 Cobrança Pix Woovi → 

03 Conciliação validada 

MAPA DO FLUXO 

Precisa de algo parecido?

[Solicitar orçamento ↗](https://wa.me/5516988724774?text=Ol%C3%A1%2C%20Weliton!%20Gostaria%20de%20um%20or%C3%A7amento%20para%20Pix%20Woovi%20com%20concilia%C3%A7%C3%A3o%20de%20pedidos.)

01 / Contexto

### O desafio

A loja precisava receber Pix com configurações claras de ambiente e manter os pagamentos locais coerentes com a cobrança do provedor.

Uma mesma finalização de compra pode gerar mais de um pedido na plataforma. Este módulo organiza uma cobrança Pix para esse grupo, mantendo os registros de pagamento vinculados a cada pedido. O objetivo técnico é conciliar o recebimento sem perder a relação com os valores locais.

A implementação UP foi estruturada com namespace próprio e documentação das regras. Ela inclui criação de cobrança, QR e copia-e-cola, prazo de validade, desconto configurável e painéis separados de produção e testes. O histórico registra implantação em ambiente de testes e validações automatizadas, sem comprovar uma operação financeira completa em produção.

02 / Passo a passo

### Como o fluxo funciona

- 01 

#### Calcular a compra

A loja reúne os pedidos e calcula o total em centavos. Quando habilitado, o desconto Pix considera o valor de produtos após descontos existentes, sem descontar frete e taxas.

- 02 

#### Criar ou recuperar

Uma referência estável identifica a cobrança. O módulo usa trava local e recuperação de cobrança existente para lidar com repetição de tentativa ou resposta demorada.

- 03 

#### Apresentar o Pix

A página exibe QR, código de pagamento e prazo. Enquanto está visível, acompanha o status local; os dados da página recebem controles para evitar cache e indexação.

- 04 

#### Verificar o recebimento

Um webhook validado ou uma conferência manual consulta a API. O módulo confere ambiente, referência, transação e valor antes de aceitar a mudança.

- 05 

#### Conciliar os pedidos

Os pagamentos nativos do grupo são atualizados conforme as regras de transição, com verificações para estados já concluídos e vínculo dos pedidos.

03 / Desenvolvimento

### O trabalho desenvolvido

Um módulo UP cria ou recupera a cobrança, apresenta o Pix e confere referência, transação e valor antes de atualizar os pedidos.

- Produção e testes com configurações próprias
- Referência estável para recuperar cobranças
- Webhook validado e consulta à API

#### Ambientes separados para reduzir confusão

As áreas administrativas de produção e testes têm credenciais, webhook, desconto e prazo próprios. Abrir uma dessas telas não muda sozinho o ambiente usado pelo checkout. Essa separação torna explícito qual configuração está sendo editada.

A página de Pix também distingue acompanhamento local de consulta ao provedor. O navegador pode acompanhar o estado sem solicitar uma nova cobrança a cada verificação. Webhook e atualização manual têm papéis específicos na conferência remota.

#### Regras testadas com limites documentados

A validação do webhook inclui token e assinatura, seguida de consulta autenticada à cobrança. A conferência não aceita apenas o valor informado em uma notificação: ela compara a resposta do serviço com o grupo de pedidos armazenado na loja.

As 98 verificações registradas são testes isolados com respostas simuladas e banco em memória. Elas não equivalem a transações reais nem substituem a homologação do fluxo completo. Uma nova implantação deve verificar pagamento, expiração, reentrega e efeitos do pedido na plataforma.

04 / Entrega

### Entrega e contexto

A versão 1.1.0 foi publicada em uma loja de testes, com 98 verificações isoladas aprovadas no histórico do projeto.

#### O que considerar na implantação

- Agrupar pedidos em uma cobrança não significa dividir dinheiro entre recebedores.
- Recorrência, carteiras, split e reembolso automático não fazem parte deste módulo.
- Expiração do QR não é cancelamento automático do pedido.

### Perguntas frequentes

O módulo pode aplicar desconto no Pix?

Existe desconto configurável sobre produtos após os descontos já existentes, preservando frete e taxas. As regras devem ser confirmadas com exemplos da loja.

É um produto pronto para qualquer instalação?

A base foi implementada e testada de forma isolada. Compatibilidade, configuração da conta e homologação financeira entram no projeto sob orçamento.

### 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çamento↗](https://wa.me/5516988724774?text=Ol%C3%A1%2C%20Weliton!%20Gostaria%20de%20um%20or%C3%A7amento%20para%20Pix%20Woovi%20com%20concilia%C3%A7%C3%A3o%20de%20pedidos.)Escopo e investimento sob medida.

### Serviços relacionados

[Módulos e customizações para Botble CMSPlugins, integrações e melhorias para lojas e sistemas baseados em Botble.↗](https://upmy.com.br/servicos/modulos-botble/)[Integração de pagamentos e APIsConecte checkout, cobranças e eventos de pagamento ao seu sistema.↗](https://upmy.com.br/servicos/integracoes-de-pagamento/)[Voltar aos projetos ↗](https://upmy.com.br/portfolio/)