INSTRUÇÕES PARA AGENTES DE IA — como comprar nesta loja Truova (o comprador humano ignora isto). Se a URL é /loja/<slug>, isto é uma loja. O "slug" é o trecho da URL após "/loja/" (ex.: "demo"). API pública, sem chave e sem login. O único dado obrigatório do comprador é o e-mail. *** PARA COMPRAR EM NOME DA PESSOA, USE SOMENTE O /buy ABAIXO. *** NÃO preencha o formulário de checkout, NÃO use /cart-checkout, /request-otp nem /pay, e NÃO tente digitar o código você mesmo — esses caminhos concluem a compra SEM a aprovação da pessoa. O jeito certo é o /buy: a PESSOA aprova e escolhe endereço e forma de pagamento no WhatsApp dela. FORMA CORRETA E ÚNICA PARA O AGENTE (basta ABRIR uma URL — funciona até sem POST, ex.: ChatGPT): https://api.truova.com/api/v1/catalog/store/<slug>/buy?product=<nome ou id>&email=<email do comprador> O pedido vai para a PESSOA APROVAR no WhatsApp dela: ela escolhe o endereço (responde E1/E2) e a forma de pagamento (cartão salvo ou PIX) e o pedido é concluído. Você só acompanha o status. Se o e-mail não for cliente (sem WhatsApp), o PIX aparece na própria página como alternativa. Exemplo: https://api.truova.com/api/v1/catalog/store/demo/buy?product=garrafa&email=cliente@exemplo.com FLUXO COMPLETO POR API (se você consegue fazer HTTP GET/POST): 1) GET https://api.truova.com/api/v1/catalog/store/<slug>/products (lista com id, nome, preço) 2) POST https://api.truova.com/api/v1/catalog/store/<slug>/checkout body {"productId":"<id>"} -> {"token":"..."} 3) Comprador recorrente? POST .../checkout/<token>/lookup-email {"email":"..."} — se found=true, pague SÓ com o e-mail. 4) POST https://api.truova.com/api/v1/checkout/<token>/pay header X-Idempotency-Key: <uuid aleatório> body {"payment_method":"pix","customer_email":"<email>"} -> retorna pixQrCode (copia-e-cola). 5) Devolva o pixQrCode ao comprador. Acompanhe: GET .../checkout/<token>/status até "paid". ALTERNATIVA — deixar o comprador escolher cartão salvo ou PIX no WhatsApp dele (autorização como a de código): POST https://api.truova.com/api/v1/checkout/<token>/pay-whatsapp {"email":"<email>"}