Como testar a integração completa antes de aceitar a entrega

1. Desenhe o percurso e identifique versões

Antes de testar, desenhe a sequência que a equipe espera: cliente escolhe equipamento e ciclo, informa pagamento, recebe confirmação, o controlador libera o comando, a máquina inicia, o ciclo termina e os registros ficam disponíveis para consulta. Se houver aplicativo, terminal, gateway, rede local, nuvem ou serviço de máquina, identifique cada componente e seu responsável. Um “teste de pagamento” isolado não verifica toda a cadeia.

Registre fabricante, modelo, SKU brasileiro, número de série, versão de controle e versão do software de cada item. Anote configuração de preço, ciclo, meio de pagamento e data da homologação. A matriz evita que o fornecedor cite teste feito com outro modelo ou versão como comprovação. Caso alguma informação não esteja disponível, registre a lacuna e peça declaração do responsável técnico pela integração.

Use ambiente de teste ou procedimento aprovado pelo fornecedor para evitar cobranças reais. Se uma transação de produção for indispensável, limite-a, identifique-a previamente e combine cancelamento ou devolução conforme o meio utilizado. Não use dados pessoais reais em sandbox, nem grave número completo de cartão, senha, QR dinâmico ou credenciais de acesso em planilha de aceite. O responsável pela privacidade e o integrador devem indicar quais dados podem ser preservados.

2. Defina sucesso, falha e evidência antes do ensaio

Escreva o resultado esperado para cada cenário antes de executar. Uma tabela simples pode incluir estado inicial, ação, resposta de pagamento, comando enviado, resposta do controle, estado físico da máquina, registro gerado e responsável por corrigir divergência. Defina também o que é bloqueador para aceite: cobrança sem ciclo, ciclo sem pagamento, duplicidade, ausência de registro ou impossibilidade de reconciliar. Um critério acordado evita discutir depois se uma anomalia era “normal”.

Sincronize relógios e identifique fuso horário. Guarde ID da transação ou referência interna, equipamento, horário e resultado, com dados mínimos suficientes para investigação. A API Pix, quando essa arquitetura é usada, prevê elementos de cobrança e referências que podem apoiar confirmação e conciliação; o Banco Central documenta recursos próprios do arranjo. Isso não significa que uma interface seja automaticamente conciliada ou adequada ao seu sistema.

Peça ao integrador que mostre logs nos componentes relevantes e explique qual evento prova cada etapa. O registro de pagamento aprovado não prova que o comando chegou; o comando enviado não prova que a máquina iniciou. Se um lado não emite confirmação, registre essa limitação e defina como reconciliar manualmente sem repetir a liberação ou cobrar de novo.

3. Teste o fluxo normal de ponta a ponta

Com a equipe autorizada, teste cada combinação de meio de pagamento, preço e equipamento que a loja pretende disponibilizar. Confirme seleção do ciclo, valor apresentado, pagamento, confirmação, comando, início da máquina, atualização do painel e conclusão. Repita em pelo menos uma configuração representativa por tipo de controle e documente o racional para os equipamentos semelhantes. Um único terminal em uma lavadora não valida automaticamente secadoras ou outra família.

Verifique se o valor recebido corresponde ao preço aplicado naquele equipamento e se uma alteração programada aparece onde esperado. Confirme se o cliente recebe mensagem clara e se a equipe consegue identificar uma máquina. Quando há ciclos ou preços diferentes, teste cada regra, não apenas a opção mais comum. Se a operação tiver cortesia, crédito ou saldo, ensaie a condição separadamente e confirme como ela aparece nos registros.

Depois do início, deixe o ciclo concluir conforme instrução da máquina. Confira quais registros mudam durante e ao final, quais alertas são enviados e se a finalização atualiza estado. Não encurte, pause ou avance ciclo por procedimento não aprovado pelo fabricante. Se o sistema só informa liberação, escreva isso como limite e estabeleça a rotina de confirmação física.

Quando houver Pix, confirme o fluxo com a instituição e a implementação contratada. O Banco Central mantém informações sobre Pix Cobrança e API Pix; o Manual de Padrões para Iniciação do Pix documenta padrões de iniciação, mas não atesta a integração do terminal específico.

4. Ensaie recusas, atrasos e repetição

Inclua pagamento recusado ou cancelado antes do comando, pagamento confirmado sem retorno imediato, retorno tardio, máquina indisponível, terminal sem rede e reinício controlado pelo fornecedor. O teste deve confirmar que uma falha não libera ciclo sem pagamento nem gera uma cobrança duplicada quando o operador tenta novamente. Se a plataforma usa eventos assíncronos, peça que o fornecedor explique como identifica a referência da operação e trata a repetição.

Teste o caso em que o pagamento é confirmado e a máquina não inicia. O cliente não deve ficar sem orientação, e a equipe precisa localizar a transação, equipamento e horário para decidir atendimento. Defina quem autoriza uma nova liberação, crédito ou devolução e como a ação fica registrada. Não resolva com transferência manual ou pagamento por outro sistema sem protocolo, pois isso pode criar duplicidade e dificultar conciliação.

Se houver QR Pix, o Banco Central oferece orientações sobre cobrança e devolução vinculada à transação original. O procedimento depende do tipo de cobrança e das ferramentas em uso; siga a configuração documentada pelo recebedor. Não declare prazo de devolução nem comportamento de um provedor sem contrato e confirmação. Para outros meios, peça procedimento equivalente ao prestador responsável e mantenha a marca fora do guia se não for necessária para explicar o método.

5. Verifique interrupção e fechamento de registros

Simule interrupção no ponto de teste seguro definido pelos técnicos: perda de comunicação, controladora reiniciada ou indisponibilidade temporária do painel. Não provoque falha elétrica, abra máquina ou remova cabo energizado. Observe se os dados ficam pendentes, se retornam após reconexão e se mantêm horário e referência. Confirme o que funciona localmente e o que exige serviço externo para concluir o ciclo.

Concilie dados do meio de pagamento com comandos e ciclos. Compare valor, identificador, máquina, horário e situação final. Registre estorno, transação de teste, ciclo de cortesia e atendimento manual em categorias diferentes. A equipe financeira deve definir quais relatórios comprovam recebimento e qual documento contábil usar. O painel de máquina não deve ser presumido como extrato de liquidação financeira.

Faça uma exportação de amostra e verifique se os dados são legíveis, completos e com unidade temporal clara. Se o sistema não exporta, registre a alternativa e o risco de guardar apenas captura de tela. Preserve apenas informações necessárias para o objetivo de teste e aplique controle de acesso. A LGPD exige princípios e medidas relacionadas a dados pessoais tratados; não copie dados de cliente para um documento técnico quando referência de teste pode resolver.

Se logs ou recibos contiverem dados pessoais, avalie o tratamento à luz da LGPD, limitando acesso e retenção conforme finalidade e obrigações aplicáveis.

6. Atribua cada defeito e peça plano de correção

Monte um registro por falha com identificação, cenário, resultado esperado, resultado observado, evidência, responsável primário, dependência de terceiro, prioridade e prazo acordado. Uma falha entre pagamento e máquina pode estar em qualquer interface; não conclua a causa antes de os responsáveis compararem logs. Defina um ponto de contato que coordene o chamado e impeça que a operação seja transferida repetidamente entre empresas.

Separe bloqueadores de aceite, limitações documentadas e melhorias futuras. Um problema que permite cobrança sem liberação costuma ter consequência diferente de um relatório que demora mais que o desejado. A classificação deve ser aprovada pelo operador, integrador e responsável técnico antes do ensaio. Se uma etapa não é suportada, decida se o processo manual é aceitável e quem vai executá-lo; não esconda o limite dentro de uma nota informal.

Reexecute os casos que falharam após a correção e guarde a evidência anterior e posterior. Não sobrescreva o resultado original: o histórico mostra o que foi corrigido. Registre versão implantada e data. Mudanças futuras de software, preço, terminal ou máquina podem alterar o comportamento e devem passar por teste de regressão definido no contrato de suporte.

7. Emita aceite condicionado à prova e ao pacote entregue

O aceite deve reunir a matriz de versões, roteiro executado, resultados, incidentes, pendências, documentação e contatos. Confirme que credenciais individuais foram entregues em canal seguro e que acessos temporários de teste foram revogados. Registre manual de operação, processo de atendimento a pagamento sem ciclo, cancelamento, devolução, indisponibilidade e escalonamento de suporte. Se a entrega depende de uma etapa futura, anote prazo e efeito no pagamento final conforme contrato.

Não aprove a integração apenas porque a máquina funcionou uma vez durante a apresentação. A equipe precisa demonstrar que consegue atender exceções e localizar o ocorrido. Se o fornecedor não autoriza determinados testes, registre o limite e peça alternativa documental ou homologação formal do fabricante. Quando faltar prova essencial, mantenha o ponto como pendência e não trate a entrega como completamente aceita.

Após a inauguração, revise os primeiros registros de produção, sem usar dados mais amplos do que o necessário. Compare pagamento, liberação e ciclo em pequena amostra autorizada e corrija divergências por procedimento. O guia sobre comparar pulso e integração suportada ajuda a avaliar as capacidades da interface; este artigo é o roteiro de teste do conjunto completo, com evidências e aceite.

Defina quem pode observar e registrar cada etapa durante o teste. Uma pessoa pode acompanhar a tela de pagamento, outra a resposta da máquina e um terceiro representante técnico revisar logs; anote os nomes e papéis. Evite que uma mesma pessoa altere preço e valide a conciliação sem conferência independente quando a equipe permitir. Em uma equipe pequena, mantenha ao menos o histórico e a aprovação identificados para que a trilha não dependa da memória de quem estava no turno.

Perguntas frequentes