Tracking server-side para CCV Shop
Ligue as suas chaves de API do CCV Shop e clique em Create webhook. O CCV comunica então cada encomenda paga à ROASaurus, que a envia para as suas plataformas de anúncios a partir do servidor.
| O CCV Shop em resumo | |
|---|---|
| As encomendas chegam por | Webhook (encomenda paga) 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 dos pedidos | HMAC-SHA512 em cada chamada à API |
| Snippet da página de agradecimento | Página de sucesso da encomenda, com Vertoshop.getOrder().getId() |
Como o CCV Shop se liga
- Adicione o script da ROASaurus a todas as páginas: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, ou um bloco de código de uma app no cabeçalho.
- Adicione o snippet da página de agradecimento à página de sucesso da encomenda.
- Mijn webshop › Instellingen › Algemeen › API gegevens: copie a chave pública e a chave secreta. Se não vir API gegevens, instale primeiro a app de API.
- Introduza ambas as chaves na ROASaurus, guarde e clique em Create webhook.
O que faz o Create webhook
A ROASaurus regista um webhook do CCV para o evento order paid. O CCV comunica então cada encomenda paga de imediato. Quando o CCV devolve um segredo de webhook, a ROASaurus verifica a assinatura HMAC-SHA512 de cada entrega; cada entrega tem também de trazer o token exclusivo da sua loja. A ROASaurus obtém depois a encomenda completa e as suas linhas de encomenda a partir da API.
Cada chamada à API que a 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 timestamp.
A verificação de 5 minutos
A ROASaurus também pede ao CCV as encomendas pagas a cada 5 minutos. O CCV só filtra por data de criação, por isso uma encomenda que é marcada como paga dias depois de ter sido feita é captada pelo webhook, não pela verificação.
O que a ROASaurus lê de cada encomenda
O número completo da encomenda, o total, a moeda, o email do cliente, o número de telemóvel ou de telefone, o nome, a cidade, o código postal e o país de faturação, o ID do cliente e cada linha de encomenda com o número do produto, a quantidade e o preço.
Limites
- As encomendas do CCV não incluem o endereço IP do comprador, pelo que a alternativa por IP não está disponível. Adicione o snippet da página 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 guardar as suas credenciais, faça uma encomenda de teste e verifique o Event log.
Relacionado
Perguntas e respostas
Onde encontro as chaves de API do CCV Shop?
Em Mijn webshop › Instellingen › Algemeen › API gegevens. Se esse menu não existir, instale primeiro a app de API do CCV.
O que faz o snippet da página de sucesso da encomenda?
Lê o ID da encomenda com Vertoshop.getOrder().getId() e dispara com ele a compra da ROASaurus, o que associa a encomenda ao visitante e ao seu clique no anúncio.
As encomendas pagas mais tarde continuam a ser enviadas?
Sim, através do webhook de encomenda paga. A verificação de 5 minutos só analisa as encomendas criadas recentemente, por isso mantenha o webhook ativo.
Cada venda, associada ao anúncio que a gerou
Tracking server-side, lucro e valor vitalício do cliente numa só app. Teste gratuito de 14 dias, sem cartão de crédito.
Comece o seu teste gratuito →