Pular para o conteúdo

Compra por agente: um roteiro de homologação

Do catálogo ao pós-venda, cada passagem precisa deixar um resultado conferível.

Homologar uma compra por agente exige demonstrar consulta, cálculo, autorização, pagamento e criação do pedido, incluindo falhas e retomadas. O protocolo organiza a troca de mensagens; a loja continua responsável por aplicar suas regras. Uma resposta de sucesso isolada não comprova que mercadoria, cobrança e atendimento estão conciliados.

Imagine um teste hipotético em que o assistente recebe confirmação de compra, mas a loja não encontra o pedido. O pagamento pode ter sido autorizado enquanto a criação do pedido falhou, ou a resposta pode representar apenas uma solicitação aceita. Sem distinguir os estados, o atendimento promete uma entrega que ainda não existe.

O roteiro de homologação precisa acompanhar a mesma compra por todos os sistemas. Use dados de teste e identificadores que permitam relacionar sessão, tentativa de pagamento e pedido. O objetivo inicial é entender o caminho e suas exceções, antes de ampliar o volume.

Neste guia
  1. Como delimitar o teste?
  2. Quais passagens precisam de evidência?
  3. Como testar falhas e repetição?
  4. Quando a pessoa deve retomar a compra?
  5. Qual evidência encerra a homologação?

Como delimitar o teste?

Declare canal, versão do protocolo, operações, meio de pagamento, categoria de produto e responsáveis. Separe o que será simulado do que será executado no ambiente de testes do parceiro. Uma simulação de resposta bancária não comprova que a integração financeira real está homologada.

Escolha uma cesta simples e uma condição que force interrupção. Por exemplo, um item com disponibilidade e outro que perde a reserva. O guia de comparação de protocolos ajuda a identificar o contrato usado, mas o aceite deve descrever comportamento, não apenas siglas.

Quais passagens precisam de evidência?

  1. Consultar o item e registrar a variante escolhida.
  2. Recalcular total, entrega e condições no sistema da loja.
  3. Obter a aprovação exigida pelo fluxo negociado.
  4. Confirmar o estado do pagamento no provedor.
  5. Criar ou localizar o pedido associado à tentativa.
  6. Informar confirmação, pendência ou recusa ao comprador.

Em cada passagem, registre entrada, saída, horário e identificadores, sem guardar segredos de pagamento nos relatórios. A especificação de checkout UCP descreve operações e estados; isso não elimina a necessidade de mapear esses estados para o pedido e o atendimento da empresa.

Como testar falhas e repetição?

Interrompa a comunicação depois de enviar a solicitação e antes de receber a resposta. A retomada deve consultar o estado ou repetir a operação com a proteção prevista, sem criar uma segunda compra. No contrato ACP consultado, operações de checkout possuem regras específicas de idempotência; o integrador precisa demonstrar seu uso.

Inclua mensagem repetida, mensagem atrasada e evento fora de ordem. A documentação de webhooks da Stripe mostra que a integração deve lidar com essas situações e verificar a origem das notificações. Um evento recebido duas vezes precisa atualizar a mesma transação, não gerar duas separações no estoque.

Quando a pessoa deve retomar a compra?

Defina pontos de intervenção para mudança de preço, nova condição, autenticação adicional, risco e dados incompletos. A pessoa precisa receber contexto suficiente para continuar sem recomeçar às cegas. Um redirecionamento para a loja pode ser parte legítima do fluxo, desde que conserve o estado necessário.

No UCP de 25/08/2026, não se deve presumir conclusão autônoma sem a extensão de mandatos AP2 aplicável. Mesmo num fluxo que a aceite, uma falha de verificação precisa impedir a conclusão. A operação do checkout por agente detalha as decisões que permanecem no servidor.

Qual evidência encerra a homologação?

O caso aprovado termina com valores, identificadores e estados conciliados. O caso recusado termina sem cobrança ou reserva indevida. O caso pendente possui responsável, prazo de investigação e mensagem correta ao comprador. A equipe deve saber cancelar ou devolver quando essa ação for cabível.

O curso Software e IA para executivos ajuda a formular critérios de aceite. Prepare uma planilha com cenário, resultado esperado, evidência e responsável. Só libere a cesta do exemplo depois de operação, financeiro e atendimento conseguirem explicar o mesmo resultado, inclusive quando a comunicação falhar.

Perguntas frequentes

Uma demonstração feliz basta para homologar?

Não. O aceite deve incluir falhas, recusas e repetição, porque esses casos mostram como evitar cobrança, pedido ou reserva duplicados.

Posso testar apenas com respostas simuladas?

Simulações ajudam no desenvolvimento, mas não substituem testes no ambiente do parceiro para comprovar a integração efetiva com ele.

Por Alexandre Caramaschi, Brasil GEO. Publicado em . Revisado em .

Fontes