Quando um cliente paga pela Stripe ou pela Shopify, o provedor de pagamento envia à Provedly um webhook assinado. A Provedly confere a assinatura, armazena o pedido com a sua origem, e o widget na sua página mostra uma notificação com o selo Compra verificada. Nada além disso pode ganhar esse selo, e é isso que faz valer a pena exibi-lo.
A cadeia de custódia
Uma notificação verificada é o último elo de uma cadeia curta, e cada elo pode ser conferido.
- Um checkout é concluído. O cliente paga no seu checkout com Stripe ou na sua loja Shopify. A Provedly não participa do pagamento em si.
- O provedor envia um webhook. Stripe e Shopify assinam o payload com um segredo que só eles e a sua conta Provedly conhecem. O payload descreve o pedido, não o cartão.
- A Provedly verifica a assinatura. Um payload com assinatura ausente ou que não confere é rejeitado. Não existe caminho alternativo em que uma requisição sem assinatura seja aceita porque "parece certa".
- O pedido é armazenado com a sua origem. O registro é marcado como vindo da Stripe ou da Shopify. É essa marcação que o widget e a página de verificação leem depois; ela nunca é definida por um campo de formulário.
- O widget renderiza a notificação. O script na sua página busca os eventos recentes e os exibe dentro de um Shadow DOM, assim o CSS do seu site e o do widget não atrapalham um ao outro.
- O selo leva para fora. Cada notificação traz um selo que abre a sua página de verificação pública, onde o visitante vê as origens, as contagens e a compra verificada mais recente.
Se alguma etapa não puder ser concluída, a notificação não aparece como verificada. Registros que chegam à Provedly por outro caminho são identificados sem exceção: registros adicionados à mão mostram Sample, e registros de upload de CSV ou da Records API mostram Imported.
O que o visitante vê
A notificação é pequena e breve por definição. Ela diz o que foi comprado e mais ou menos quando, e traz o selo Compra verificada. O tempo padrão é conservador:
| Configuração | Padrão |
|---|---|
| Espera antes da primeira notificação | 3 segundos |
| Tempo que cada notificação fica visível | 6 segundos |
| Intervalo entre notificações | 30 segundos |
| Máximo por sessão | 5 |
Esses padrões resultam em cerca de três notificações numa visita típica. Você pode apertá-los ainda mais, e para a maioria dos sites essa é a direção certa. O raciocínio está em /pt/blog/notifications-per-visit-frequency.
O script inteiro é uma tag com cerca de 6 KB com gzip, então a notificação chega sem deixar lenta a página que ela deveria ajudar. Regras de segmentação decidem quais páginas e dispositivos a veem, assunto de /pt/blog/where-to-show-social-proof-page-targeting.
O que "verificado" significa, e o que não significa
Vale ser preciso aqui, porque a palavra costuma ser esticada.
Verificado significa que o registro de compra veio de um webhook assinado enviado pela Stripe ou pela Shopify. Ninguém da sua empresa digitou o registro, e ele não foi importado de uma planilha. A origem fica registrada e aparece na página de verificação.
Verificado não significa que a Provedly inspecionou os produtos, confirmou a entrega ou avaliou o cliente. É uma afirmação sobre a origem dos dados, que é justamente a parte que a prova social fabricada erra. Tudo o que vem depois, como reembolsos ou chargebacks, fica entre você e o seu provedor de pagamento.
Essa definição estreita é proposital. Uma afirmação que você consegue sustentar por inteiro é mais útil do que uma ampla que você não consegue.
A página de verificação
Cada selo leva a uma página pública do seu site. Ela mostra:
- Quais origens estão conectadas (Stripe, Shopify ou ambas).
- Quantos registros são verificados e quantos são exemplos.
- Quando chegou a compra verificada mais recente.
- A política de honestidade que o widget segue, incluindo o que o contador ao vivo faz quando o tráfego está baixo.
Toda noite, a Provedly calcula uma raiz SHA-256 sobre o histórico e a registra. Se um registro antigo fosse alterado ou apagado, a raiz deixaria de bater, então a página não pode ser reescrita discretamente para parecer melhor do que foi. A política em si está publicada em /pt/trust, e os argumentos para ter uma página assim estão em /pt/blog/why-social-proof-needs-verification-page.
Como conectar uma origem
Stripe. Você adiciona um endpoint de webhook no dashboard da Stripe apontando para o endereço que a Provedly fornece e cola o segredo de assinatura na Provedly. A partir daí, os pagamentos concluídos chegam automaticamente. As instruções passo a passo, incluindo quais eventos assinar, estão em /pt/docs.
Shopify. Você instala o app da Provedly pela Shopify App Store. O app registra os webhooks de pedidos para você e cobra pelo Shopify Billing, então não há um cartão separado para cadastrar. A exibição do widget na loja usa uma theme app extension, que você ativa no editor de temas sem mexer no código do tema.
Os dois caminhos terminam no mesmo lugar: um registro marcado com a sua origem e uma notificação que consegue provar de onde veio.
Duas observações práticas
Mantenha os dados do cliente no mínimo.
Uma notificação não precisa de muito para convencer. O que foi comprado e o fato de ter sido comprado há pouco carregam o peso. Trate qualquer dado do cliente como algo a justificar, e não como algo a incluir por padrão, e mantenha os campos exibidos no mínimo de que o seu público precisa. Mostrar menos também mantém você longe de obrigações de privacidade que variam de região para região. O foco da notificação é o evento, não a pessoa.
Quando ainda não há pedidos.
Se nada foi vendido recentemente, nada verificado é exibido. Isso pode incomodar numa loja nova, mas é o estado honesto, e existem formas legítimas de lidar com ele. Você pode pré-visualizar o widget com registros Sample claramente identificados e pode se apoiar nas barras CTA em /pt/features#bars enquanto os pedidos verificados se acumulam. O que você não deve fazer é fabricar a aparência de vendas, e a Provedly não oferece nenhum jeito de fazer isso.
Perguntas frequentes
Posso editar um registro verificado depois que ele chega?
A marcação de origem é definida pelo webhook e não pode ser editada. Ocultar um registro da exibição é uma coisa diferente de mudar o rótulo dele, e nada do que você faça no dashboard transforma um exemplo em compra verificada.
E se o segredo do webhook da Stripe mudar?
Atualize o segredo na Provedly. Payloads assinados com um segredo desconhecido são rejeitados em vez de aceitos na confiança, então um segredo desatualizado interrompe os novos registros verificados até ser corrigido.
Pedidos reembolsados continuam verificados?
O registro continua sendo um evento de compra genuíno vindo do provedor. Como você trata reembolsos na exibição é uma decisão de política da sua loja, e a página de verificação continua refletindo o que realmente chegou.
Conecte a Stripe ou a Shopify no plano gratuito, que inclui compras verificadas: /register.