Rastreamento server-side para CCV Shop
Conecte as suas chaves de API do CCV Shop e clique em Create webhook. O CCV então informa cada pedido pago ao ROASaurus, que o envia às suas plataformas de anúncios a partir do servidor.
| O CCV Shop em resumo | |
|---|---|
| Os pedidos chegam por | Webhook (order paid) mais polling a cada 5 minutos |
| Configuração do webhook | Automática, com o botão Create webhook |
| Credenciais | Chave pública e chave secreta de API gegevens |
| Assinatura das requisições | HMAC-SHA512 em cada chamada de API |
| Snippet de agradecimento | Página de sucesso do pedido, usando Vertoshop.getOrder().getId() |
Como o CCV Shop se conecta
- Adicione o script do ROASaurus a todas as páginas: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, ou um bloco de código de app no cabeçalho.
- Adicione o snippet de agradecimento à página de sucesso do pedido.
- Mijn webshop › Instellingen › Algemeen › API gegevens: copie a chave pública e a chave secreta. Se você não vir API gegevens, instale primeiro o app de API.
- Informe as duas chaves no ROASaurus, salve e depois clique em Create webhook.
O que o Create webhook faz
O ROASaurus registra um webhook do CCV para o evento order paid. O CCV então informa cada pedido pago imediatamente. Quando o CCV devolve um segredo de webhook, o ROASaurus verifica a assinatura HMAC-SHA512 de cada entrega; cada entrega também precisa levar o token exclusivo da sua loja. O ROASaurus então busca o pedido completo e as linhas do pedido na API.
Toda chamada de API que o ROASaurus faz é assinada da forma que o CCV exige: um hash HMAC-SHA512 da sua chave pública, do método, do endereço, do corpo e de um carimbo de data e hora.
A verificação de 5 minutos
O ROASaurus também pede ao CCV os pedidos pagos a cada 5 minutos. O CCV só filtra pela data de criação, então um pedido marcado como pago dias depois de ser feito é captado pelo webhook, e não pela verificação.
O que o ROASaurus lê de cada pedido
O número completo do pedido, o total, a moeda, o e-mail do cliente, o número de celular ou telefone, o nome, a cidade, o CEP e o país de cobrança, o ID do cliente e cada linha do pedido com o número do produto, a quantidade e o preço.
Limites
- Os pedidos do CCV não incluem o endereço IP do comprador, então a alternativa por IP não está disponível. Adicione o snippet de agradecimento.
- Mantenha o webhook ativo: os pagamentos tardios dependem dele.
- O conector foi criado com base na documentação oficial da API da plataforma. Clique em Test connection depois de salvar as suas credenciais, faça um pedido de teste e confira o Event log.
Relacionados
Perguntas respondidas
Onde encontro as minhas chaves de API do CCV Shop?
Em Mijn webshop › Instellingen › Algemeen › API gegevens. Se esse menu não aparecer, instale primeiro o app de API do CCV.
O que o snippet da página de sucesso do pedido faz?
Ele lê o ID do pedido com Vertoshop.getOrder().getId() e dispara com ele a compra do ROASaurus, o que liga o pedido ao visitante e ao clique dele no anúncio.
Os pedidos pagos depois ainda são enviados?
Sim, pelo webhook de pedido pago. A verificação de 5 minutos só olha os pedidos criados recentemente, então mantenha o webhook ativo.
Cada venda, rastreada até o anúncio que a gerou
Rastreamento server-side, lucro e valor vitalício em um só app. 14 dias de teste grátis, sem cartão de crédito.
Comece seu teste grátis →