Sua loja pronta pro carrinho.chat

Seu Kit de Integração em 3 passos

1. 1Publique o /llms.txt

   Copiar

   Na raiz do domínio, em Markdown, até 2.000 caracteres. Diz ao agente o que você vende e que aceita compra via carrinho.chat.

   # {{NOME_DA_LOJA}}
   
   {{NOME_DA_LOJA}} vende {{O_QUE_VOCE_VENDE}}.
   
   ## Compras por agente
   
   Esta loja aceita compras feitas por agentes de IA via carrinho.chat: o agente monta o carrinho e uma pessoa aprova e paga por Pix na tela do carrinho.chat.
   
   ## MCP do carrinho.chat
   
   Se o seu agente ainda não tem o MCP do carrinho.chat, a pessoa pega a URL de conexão em https://carrinho.chat/ e cola no agente.
   
   ## Protocolo
   
   - Perfil UCP: https://sualoja.com.br/.well-known/ucp
   
   ## Política
   
   Devolução em 7 dias corridos após o recebimento, sem justificativa (a loja paga o frete de volta). Prazo de envio: até {{PRAZO}} dias úteis. Detalhes: https://sualoja.com.br/politica
   

2. 2Publique o manifesto /.well-known/ucp

   Copiar

   Perfil UCP 2026-08-25 com o handler chat.carrinho.pix_brcode (sua chave Pix) e os dados do lojista chat.carrinho.merchant. Troque os campos entre chaves duplas.

   {
     "ucp": {
       "version": "2026-08-25",
       "services": {
         "dev.ucp.shopping": [
           {
             "version": "2026-08-25",
             "spec": "https://ucp.dev/2026-08-25/specification/overview/",
             "transport": "rest",
             "endpoint": "https://sualoja.com.br",
             "schema": "https://ucp.dev/2026-08-25/services/shopping/rest.openapi.json"
           }
         ]
       },
       "capabilities": {
         "dev.ucp.shopping.catalog.search": [
           {
             "version": "2026-08-25",
             "spec": "https://ucp.dev/2026-08-25/specification/shopping/catalog/search",
             "schema": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_search.json"
           }
         ],
         "dev.ucp.shopping.catalog.lookup": [
           {
             "version": "2026-08-25",
             "spec": "https://ucp.dev/2026-08-25/specification/shopping/catalog/lookup",
             "schema": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_lookup.json"
           }
         ],
         "dev.ucp.shopping.checkout": [
           {
             "version": "2026-08-25",
             "spec": "https://ucp.dev/2026-08-25/specification/shopping/checkout",
             "schema": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json"
           }
         ],
         "dev.ucp.shopping.fulfillment": [
           {
             "version": "2026-08-25",
             "spec": "https://ucp.dev/2026-08-25/specification/shopping/extensions/fulfillment",
             "schema": "https://ucp.dev/2026-08-25/schemas/shopping/fulfillment.json",
             "extends": "dev.ucp.shopping.checkout"
           }
         ],
         "dev.ucp.shopping.order": [
           {
             "version": "2026-08-25",
             "spec": "https://ucp.dev/2026-08-25/specification/shopping/order",
             "schema": "https://ucp.dev/2026-08-25/schemas/shopping/order.json"
           }
         ],
         "chat.carrinho.merchant": [
           {
             "version": "2026-11-09",
             "spec": "https://carrinho.chat/ucp/chat.carrinho/merchant.json",
             "schema": "https://carrinho.chat/ucp/chat.carrinho/merchant.schema.json",
             "config": {
               "razao_social": "{{RAZAO_SOCIAL}}",
               "cnpj": "{{CNPJ}}",
               "email_suporte": "{{EMAIL_DE_ATENDIMENTO}}",
               "politica_devolucao_url": "https://sualoja.com.br/politica",
               "prazo_envio_dias": 3,
               "ficticio": false
             }
           }
         ]
       },
       "payment_handlers": {
         "chat.carrinho.pix_brcode": [
           {
             "id": "chat.carrinho.pix_brcode",
             "version": "2026-11-09",
             "spec": "https://carrinho.chat/ucp/chat.carrinho/pix_brcode.json",
             "schema": "https://carrinho.chat/ucp/chat.carrinho/pix_brcode.schema.json",
             "config": {
               "pix_key": "sua-chave-pix@sualoja.com.br",
               "merchant_name": "{{NOME_NO_PIX_ATE_25}}",
               "city": "{{CIDADE_ATE_15}}"
             },
             "available_instruments": [
               {
                 "type": "pix"
               }
             ]
           }
         ]
       }
     },
     "keys": [
       {
         "kty": "EC",
         "crv": "P-256",
         "x": "{{CHAVE_PUBLICA_X}}",
         "y": "{{CHAVE_PUBLICA_Y}}",
         "kid": "{{ID_DA_CHAVE}}",
         "use": "sig",
         "alg": "ES256"
       }
     ]
   }

3. 3Webhook de pedidosopcional

   Copiar

   Sem webhook, o carrinho.chat consulta o pedido na sua API. Com webhook, a confirmação chega na hora.

   POST https://carrinho.chat/api/webhooks/lojas
   Content-Type: application/json
   Content-Digest: sha-256=:{{SHA256_DO_CORPO_BASE64}}:
   Webhook-Id: {{EVENT_ID}}
   Webhook-Timestamp: {{UNIX_SEGUNDOS}}
   Signature-Input: sig1=("@method" "@path" "content-digest" "webhook-id" "webhook-timestamp");created={{UNIX_SEGUNDOS}};keyid="{{ID_DA_CHAVE}}";alg="ecdsa-p256-sha256"
   Signature: sig1=:{{ASSINATURA_ES256_BASE64}}:
   
   {
     "event_id": "{{EVENT_ID}}",
     "type": "order.paid",
     "occurred_at": "2026-11-07T12:00:00Z",
     "order": {
       "id": "{{ID_DO_PEDIDO}}",
       "chat.carrinho.status": "paid"
     }
   }
   
   # Eventos: order.paid, order.shipped, order.delivered, return.approved, return.rejected, return.received, refund.issued.
   # Assine com a chave privada cujo par público está em keys[] do seu manifesto (RFC 9421, ES256).
   # Loja: https://sualoja.com.br