Como checar se a sua loja tem o perfil UCP, passo a passo

Quando um assistente de IA quer comprar na sua loja, ele procura o perfil do comerciante. Se o perfil não existe, o assistente não sabe o que pedir. Este tutorial mostra como verificar se a sua loja tem o perfil e o que ele diz.

Passo 1: confira se o perfil existe

O perfil fica em /.well-known/ucp. Abra o terminal e rode o comando. Troque o valor de D pelo domínio do seu site:

D=seudominio.com.br
curl -s -o /dev/null \
  -w "%{http_code}\n" \
  https://$D/.well-known/ucp

Se o resultado for 200, o perfil existe. Se for 404, a sua loja não tem o perfil publicado, e o assistente não consegue usar o UCP com ela.

Passo 2: leia o conteúdo

Abra o endereço no navegador. O conteúdo é um JSON. Procure pela lista de serviços. Ela deve dizer se há catálogo e checkout. Se algum dos dois estiver ausente, o assistente só consegue parte da compra.

Passo 3: entenda a lista de pagamentos

O perfil traz uma lista de manipuladores de pagamento, o campo payment_handlers. Se a lista estiver vazia, a loja não informa ao assistente nenhum meio de pagamento. Nesse caso, o pagamento só acontece na página do carrinho, com a pessoa.

Esse é um desenho possível e seguro. Mas você deve decidir, de forma consciente, se quer ou não informar os meios de pagamento.

Passo 4: confira o endereço de continuação

Quando o assistente abre um checkout, a resposta traz um endereço de continuação, o continue_url. Abra esse endereço num teste e confirme que ele leva à página do carrinho. Um endereço quebrado faz o aluno desistir.

Passo 5: confira a versão

O perfil e as respostas trazem a versão do protocolo. Compare com a versão da especificação oficial, no site do UCP. Versões antigas podem não ter todos os campos.

Passo 6: documente o que você decidiu

Anote quais serviços a loja oferece, qual é a lista de pagamentos e onde o aluno conclui a compra. Essa anotação ajuda o atendimento quando o aluno perguntar por que o pagamento não saiu.

Erros comuns

O erro mais comum é o perfil em um caminho diferente, como um arquivo na raiz sem o diretório padrão. O segundo é a lista de serviços sem o checkout. O terceiro é o endereço de continuação que aponta para uma página de erro.

A especificação está no site oficial do UCP.

Passo 7: teste a loja como um assistente faria

Use o endereço do perfil para montar um carrinho de teste. Confira se o nome, o preço e a descrição do produto aparecem iguais aos da página de vendas. Se algum campo diferir, corrija no catálogo antes de liberar.

Passo 8: confira o caminho até o pagamento

Siga o endereço de continuação até a página e confira que ela mostra o carrinho certo, com o preço certo. Depois, cancele o carrinho de teste. Um carrinho esquecido aberto pode confundir a equipe mais tarde.