A IA pode ajudar a criar uma loja online personalizada, mas uma loja funcional exige preços controlados pelo servidor, estoque, coleta de pagamentos hospedada, webhooks assinados, dados de pedidos protegidos e políticas empresariais reais. Este guia Adios permanece em modo de teste e para antes de ativar pagamentos reais ou alterar a produção.
↗ Variante, moeda, preço e estoque pertencem ao catálogo.
↳ /cart
02Recalcule no servidor.
CASA / MODO DE TESTE
Duas canecas. Um carrinho.
Continuar para o pagamento
2 × EUR 18.00Subtotal: EUR 36.00
↗ Não confie no preço ou total enviado pelo navegador.
↳ provedor de pagamento / teste
03Mantenha a coleta do pagamento no provedor.
CASA / MODO DE TESTE
Apenas pagamento de teste.
Confirmação simulada
Mode: sandboxNo real charge
↗ Voltar à página de sucesso não comprova o pagamento.
↳ /orders/DEMO-42
04Deixe o evento verificado atualizar o pedido.
CASA / MODO DE TESTE
Pedido confirmado.
Ver pedido
DEMO-42 · paid (test)Duplicate event → ignored
↗ Um evento de pagamento produz uma transição do pedido.
O exemplo é um catálogo fictício de artigos para casa com variantes, estoque, carrinho, checkout de teste hospedado, histórico e administração protegida. O passo a passo ilustra o comportamento com dados simulados; sua implementação ainda precisa de todos os testes antes dos pagamentos reais. Explorar mais formas de criar com IA no Adios.
Exemplo prático / Loja de artigos para casa em modo de teste
A parte difícil começa depois de “Adicionar ao carrinho”.
Neste exemplo, duas canecas custam EUR 36 antes de frete ou impostos aplicáveis. O navegador envia IDs e quantidades; o servidor consulta preços e disponibilidade atuais. O provedor então processa o checkout de teste.
ADIOS / Do carrinho à encomendaExemplo ilustrativo
Carrinho do clienteIDs de produtos + quantidadesMUG-01 × 2
Catálogo do servidorPreço e stock atuais2 × EUR 18 = EUR 36
Pagamento alojadoFornecedor de pagamentos / modo de teste
Webhook verificadoAssinatura + deduplicação de eventos
O registo do seu negócio
DEMO-42Pago (teste)
Caneca de grés × 2EUR 36
Evento de pagamentoevt_demo_42
Inventário12 → 10
O que altera a encomenda?
✓
Um evento de pagamento verificado.
Registe o evento do fornecedor uma vez e atualize a encomenda e o inventário em conjunto.
↩
O URL de retorno serve apenas para navegar.
Mantenha a encomenda pendente até o servidor verificar o pagamento.
01
Separe os três estados.
Um carrinho é uma intenção, um pagamento é um evento do provedor e um pedido é seu registro comercial. Guarde identificadores que os conectem. Verifique a assinatura do evento antes de mudar o estado do pagamento e nunca marque um pedido como pago só por um redirecionamento do navegador.
02
Teste falhas e repetições.
Teste checkout cancelado, sessão expirada, assinatura inválida, evento repetido e compras simultâneas da última unidade. Defina quando reservar e liberar estoque. Registre falhas de atendimento separadamente para um pedido pago não desaparecer silenciosamente.
03
Prepare a operação antes do modo real.
Defina como a equipe encontra pedidos, reembolsa, corrige endereços e contata clientes. Separe a administração do histórico do cliente. Valide entrega, impostos, devoluções e suporte para seus mercados antes de ativar pagamentos reais.
Este passo a passo mostra mudanças de estado com dados fictícios. Não conecta um provedor, cria pedidos nem valida uma implantação comercial real. Os prompts abaixo ajudam a construir e testar sua implementação.
Registre os fatos dos produtos, o estoque, os países, a moeda, o frete, os impostos, os reembolsos, a privacidade, o suporte e o modo de teste do provedor.
Peça o catálogo, o carrinho, o encaminhamento ao checkout, os eventos de pagamento, os pedidos, o estoque, a administração, os testes e as decisões pendentes.
Faça um inventário dos valores de teste e revise domínio, preços, processamento de pedidos, políticas, e-mails, migração, backup, saúde, logs e reversão.
Mantenha o modo de teste até concluir todas as etapas de validação do produto e todas as decisões do proprietário. Depois, aprove explicitamente cada mudança em produção.
MODO DE TESTE — Este guia usa exemplos simulados e prompts de pagamento de teste. Complete a integração do provedor e os testes de falha no seu projeto antes de ativar pagamentos reais.
Exemplo de projeto / Loja de artigos para casa em modo de teste
Um sistema de compras, além de uma grade de produtos gerada
A comprovação começa depois do botão Adicionar ao carrinho: preços calculados no servidor, limites de estoque, checkout hospedado, eventos assinados, pedidos idempotentes e administração privada.
Totais e limites de estoque verificados no servidor.
03
Checkout
Fluxo do provedor hospedado no modo de teste.
04
Pedidos
Eventos assinados criam cada pedido uma única vez.
00
Antes de enviar o prompt
Tome as decisões comerciais antes de gerar o checkout
O código não pode decidir onde você vende, como calcula impostos, quanto custa o frete ou quais devoluções aceita. Registre essas decisões ou marque-as como pendentes antes que o agente altere os pagamentos.
ENTRADA / 01
Fatos do produto
Defina produtos, variantes, preços, moeda, regras de estoque e qual fonte é responsável por cada valor.
ENTRADA / 02
Limites do processamento de pedidos
Registre os países de entrega, as tarifas, as promessas de entrega, o comportamento do estoque e o contato de suporte.
ENTRADA / 03
Limites dos pagamentos
Use checkout hospedado e o modo de teste do provedor. Nunca colete nem armazene dados brutos de cartão na aplicação.
ENTRADA / 04
Responsabilidades com os clientes
Confirme impostos, reembolsos, devoluções, privacidade, termos, produtos proibidos e suporte antes de entrar em produção.
Uma loja é uma aplicação full-stack. Se este é seu primeiro projeto, conclua criar sua primeira aplicação com IA antes de envolver dinheiro e dados de clientes.
01
Políticas antes do pagamento
Planeje a compra de teste completa e seus limites de negócio
Preencha cada campo com uma decisão real ou escreva ‘decisão necessária’. O agente deve apontar os requisitos ausentes de impostos, frete, reembolso, privacidade e provedor antes de editar.
Prompt de planejamento da loja
Ajude-me a planejar uma pequena loja online neste espaço de trabalho Adios. Não edite arquivos ainda.
Fatos da loja:
- Nome da loja: [NOME]
- Cliente: [CLIENTE]
- Tipos de produto: [PRODUTOS]
- Variantes: [TAMANHO, COR OU OUTRAS OPÇÕES]
- Regra de estoque: [CONTROLADO, SOB ENCOMENDA OU NÃO CONTROLADO]
- Países atendidos: [PAÍSES]
- Moeda: [MOEDA]
- Provedor de pagamentos: [PROVEDOR EM MODO DE TESTE]
- Estratégia de frete: [REGRA]
- Estratégia de impostos: [REGRA OU DECISÃO AINDA NECESSÁRIA]
- Política de reembolso e devolução: [POLÍTICA REAL OU DECISÃO AINDA NECESSÁRIA]
Examine o repositório, a configuração do banco de dados, a autenticação, os testes, a rota de saúde e adios.yaml. Planeje a menor loja de teste de ponta a ponta, incluindo catálogo, detalhes do produto, carrinho, encaminhamento ao checkout, eventos de pagamento assinados, pedidos, estoque e administração protegida.
Liste as decisões que ainda preciso tomar sobre impostos, frete, reembolsos, privacidade, suporte ao cliente, produtos proibidos e requisitos do provedor de pagamentos. Aguarde minha aprovação antes de editar.
O que uma resposta útil contém
Um fluxo completo de compra em modo de teste
Fontes de referência para produtos, preços e estoque
Transições de estado de pedidos e pagamentos
Uma lista de decisões de negócios não resolvidas
02
Criar em modo de teste
Gere o catálogo, o carrinho, o encaminhamento ao checkout e o estado dos pedidos
Este prompt mantém os cálculos de preços no servidor, usa checkout hospedado, verifica eventos assinados e inclui testes de eventos duplicados na criação.
Prompt de criação da loja
Crie a versão de teste aprovada da loja online. Não ative pagamentos reais nem implante em produção.
Requisitos:
- Preserve o framework atual, o gerenciador de pacotes, a rota de saúde, os testes e os arquivos de implantação Adios.
- Armazene produtos, variantes, estoque, carrinhos e pedidos no banco de dados configurado, com relações claras e migrações reversíveis quando houver suporte.
- Calcule preços e estoque no servidor. Não confie nos totais enviados pelo navegador.
- Use o SDK oficial atual do provedor de pagamentos e o checkout de teste hospedado. Nunca colete nem armazene dados brutos de cartão.
- Verifique webhooks assinados, trate eventos duplicados de forma idempotente e registre um histórico claro do estado dos pedidos.
- Proteja as rotas administrativas e aplique permissões no servidor.
- Mantenha os segredos de pagamento, banco de dados, e-mail e sessão fora do código-fonte e liste os nomes das variáveis de ambiente.
- Adicione estados úteis de carregamento, carrinho vazio, produto esgotado, pagamento recusado, checkout cancelado e confirmação do pedido.
- Use produtos de exemplo claramente identificados como fictícios. Não invente avaliações, escassez, descontos, certificações ou promessas de entrega.
- Adicione testes de cálculo de preço, limites de estoque, autorização, rejeição de assinaturas de webhook, eventos duplicados e fluxo normal do pedido.
- Execute o formatador, o lint, os testes e a compilação de produção existentes.
Retorne os arquivos alterados, o modelo de dados, o modelo de estados do pedido, as evidências dos testes, os segredos Adios necessários e um fluxo exato de testes em Preview. Não implante.
O que uma resposta útil contém
Totais e estoque sob controle do servidor
Checkout do provedor hospedado no modo de teste
Eventos de pagamento verificados e idempotentes
Administração protegida e pedidos privados
Experimente o percurso do cliente
Uma pequena loja que pode experimentar.
Escolha um acabamento, adicione uma caneca e siga uma compra simulada. Este exemplo funciona no navegador e não efetua pagamentos reais.
FORM & FIELDCASA / DEMOCarrinho (0)
Para os rituais do dia a dia.GRÉS / 01
A coleção do dia a dia
Caneca de grés
EUR 18 / 350 ml
Compra de teste
Carrinho→Checkout→Ordem
O seu carrinho está pronto para algo bom.
Caneca de grés× 0
SubtotalEUR 0
Subtotal de exemplo antes de portes ou impostos.
Exemplo no navegador · Sem cobrança real
03
Teste falhas e reenvios
Audite a jornada de compra além do checkout bem-sucedido
Os testes úteis cobrem recusa, cancelamento, adulteração, duplicação, acesso não autorizado e falta de estoque. Este prompt pede evidências para cada caso.
Prompt de verificação da loja
Audite toda a jornada de compra da loja em modo de teste. Corrija apenas problemas confirmados e não implante.
Teste:
- navegação pelos produtos e seleção de variantes válidas;
- cálculos de preço, moeda, quantidade e estoque;
- carrinhos vazios, expirados, adulterados e com produtos sem estoque;
- eventos de checkout bem-sucedidos, recusados, cancelados e repetidos;
- assinaturas de webhook inválidas e webhooks válidos duplicados;
- criação de pedidos e atualizações de estoque ocorrendo exatamente uma vez;
- um cliente sem acesso ao pedido privado de outro cliente;
- um usuário não autenticado sem acesso à administração;
- logs sem dados de cartão, credenciais ou informações pessoais desnecessárias; e
- formatação, lint, testes, compilação e verificações de saúde.
Dê-me um resultado para cada caso, os riscos restantes e as etapas manuais que devo executar com as ferramentas de teste do provedor.
O que uma resposta útil contém
Um resultado registrado para cada cenário de falha
Pedidos e estoque alterados exatamente uma vez
Proteção do acesso de clientes e administradores
Instruções para as ferramentas de teste do provedor
04
Separe o código das responsabilidades
Prepare a decisão sobre prontidão para produção sem colocar a loja no ar
O último prompt separa as evidências técnicas das escolhas de impostos, processamento de pedidos, privacidade, suporte e políticas que só o proprietário da loja pode aprovar.
Prompt de revisão da versão da loja
Prepare esta loja para uma decisão sobre prontidão para produção. Não troque para credenciais de pagamentos reais e não implante.
Confirme o domínio de produção, as fontes de referência de produtos e preços, a moeda, o comportamento do estoque, as regiões e tarifas de frete, a decisão sobre impostos, a política de reembolso, o aviso de privacidade, os termos, o contato de suporte, os e-mails de pedidos, a URL do webhook, os nomes dos segredos, a migração do banco de dados, os backups, a rota de saúde, os logs e o plano de reversão.
Separe as verificações técnicas aprovadas das decisões empresariais ou jurídicas que continuam sob minha responsabilidade. Liste todos os valores de modo de teste e informações provisórias que precisam ser substituídos. Pare para obter aprovação explícita antes de qualquer alteração em pagamentos reais ou em produção.
O que uma resposta útil contém
Evidências técnicas separadas das decisões do proprietário
Todos os valores de modo de teste e informações provisórias listados
Notas sobre migração, backup, webhook, saúde e reversão
Nenhuma alteração de credenciais reais ou de implantação
T
Testar o resultado
Uma compilação bem-sucedida é o início da revisão
Abra Preview e percorra você mesmo os fluxos importantes. Peça evidências ao agente, mas não confunda o resumo dele com a sua aprovação.
TESTE / 01
Dinheiro e estoque
O servidor recalcula preço, moeda, quantidade, descontos e estoque antes do checkout.
Carrinhos vazios, expirados, adulterados ou com produtos sem estoque são recusados com uma próxima ação útil.
Um evento de pagamento válido cria o pedido e a movimentação de estoque exatamente uma vez.
TESTE / 02
Eventos de pagamento
As assinaturas inválidas são rejeitadas e os webhooks válidos duplicados são inofensivos.
Eventos de teste bem-sucedidos, recusados, cancelados, atrasados e repetidos têm resultados explícitos.
Nenhum dado bruto de cartão, segredo do provedor ou dado pessoal desnecessário entra no código-fonte ou nos logs.
TESTE / 03
Acesso e operações
Clientes não podem ler o pedido privado de outro cliente, e pessoas sem autorização não podem acessar a administração.
Migrações, backups, e-mail de pedidos, saúde, logs e comportamento de rollback são conhecidos.
As responsabilidades por impostos, frete, reembolso, privacidade, termos, suporte e produtos têm uma decisão do proprietário.
Etapa de aprovação humana
Mantenha a loja em modo de teste até que toda etapa de validação tenha um responsável
Este guia para intencionalmente antes dos pagamentos reais. Conclua a jornada de teste do provedor, resolva as decisões empresariais e jurídicas, substitua todos os valores de teste e obtenha aprovação explícita antes de indexar ou publicar o guia da loja como validado.
01Registre testes de sucesso, recusa, cancelamento, duplicação, assinatura inválida e falta de estoque.
02Confirme que os pedidos e o estoque são alterados exatamente uma vez e que as rotas privadas respeitam a propriedade dos dados.
03Resolva as decisões sobre impostos, frete, reembolsos, privacidade, termos, suporte, e-mail, backup e reversão.
04Liste e substitua todos os IDs de modo de teste, URLs, nomes de credenciais e conteúdos provisórios.
05Aprove alterações em pagamentos reais e em produção separadamente; uma compilação bem-sucedida não implica aprovação.
?
Perguntas antes de começar
O que este guia promete e seus limites
A IA pode criar uma loja online funcional em vez de uma maquete?+
A IA pode ajudar a gerar uma loja personalizada funcional, mas a comprovação inclui preços no servidor, estoque, checkout hospedado, eventos assinados, pedidos idempotentes, dados protegidos, testes e políticas reais. Uma grade de produtos e uma animação de carrinho não bastam.
Por que o guia requer checkout hospedado?+
O checkout hospedado mantém a coleta dos dados brutos de cartão com o provedor de pagamentos, fora da aplicação. A aplicação ainda precisa proteger os segredos do provedor, verificar eventos assinados, tratar repetições com segurança e gerenciar corretamente o estado dos pedidos.
Quem é responsável por impostos, frete, reembolsos e privacidade?+
O proprietário da loja continua responsável por essas decisões empresariais e jurídicas. A IA pode implementar regras aprovadas e apontar escolhas pendentes, mas não pode decidir quais obrigações se aplicam nem aprová-las por você.
A animação demonstra uma integração de pagamento funcional?+
Não. A animação é uma simulação educativa. Para validar sua loja, conecte um provedor em modo de teste e verifique catálogo, pagamento, eventos assinados, pedidos, estoque, acesso e recuperação na implementação real.
Comece com um espaço de trabalho que possa ser revisado
Envie o primeiro prompt ao Adios e aprove o plano.