Passar para o conteúdo principal

Integração ClearSale Total [Interno]

Documentação Interna ClearSale Total

Equipe Vnda avatar
Escrito por Equipe Vnda
Atualizado há mais de 12 meses

ClearSale Total: gestão de risco é toda feita pela ClearSale e a confirmação do pedido é feita automaticamente.

O que preciso solicitar ao cliente?

  • Fingerprint;

  • Usuário da API;

  • Senha da API.

Essas informações são enviadas por e-mail para o cliente pela ClearSale e são denominados "dados de produção" no corpo do e-mail.


Cadastro da Integração

1. Acessar admin da loja e fazer o caminho: Admin > Configurações > ClearSale > selecionar Habilitar Clearsale Total

2. Ainda na seção ClearSale no admin, preencha os campos com as informações enviadas no passo 1.

  • Ambiente: sempre selecionar Produção.

3. Cadastrar loja no app VndaRisco (risco.vnda.com.br/shops).

  • Clique em Adicionar (no final da página) e preencha da seguinte forma:

    • Host: domínio da loja

    • Usuário da API: domínio da loja

    • Senha da API: domínio da loja

4. Acessar as configurações de checkout (Admin > Geral > Checkout) e habilitar a opção Solicitar data de nascimento?.

Cadastro da URL de retorno

5. Informar ClearSale que a integração foi configurada e que a URL de retorno a ser cadastrada é a seguinte: https://risco.vnda.com.br/URL_DA_LOJA/orders/notification

  • Não esqueça de alterar *URL_DA_LOJA* para o host da loja sem o https://

Utilizar a macro ClearSale - cadastro URL de retorno no Zendesk para solicitar o cadastro.

👉O e-mail para contato é o central.relacionamento@clear.sale.

6. Após a confirmação da ClearSale, faça um pedido teste e valide se aparece a análise da ClearSale.

  • Caso o pedido tenha sido aprovado, ele deve ter sido confirmado automaticamente.

  • Os pedidos não são cancelados automaticamente pela ClearSale. Apenas a confirmação automática é feita.


CONFIGURAÇÕES ADICIONAIS - caso ocorra algum erro na integração com ClearSale Total

  • Reenvio de pedidos:

Na situação dos pedidos recebidos no painel Vnda com status da Clearsale de “AGUARDANDO PEDIDO”, podemos cadastrar esse webhook nas configurações da loja para reenviar para Clersale: https://risco.vnda.com.br/url_da_loja/orders

Obs: deve atualizar a parte url_da_loja conforme host da loja.

Após reenviar os pedidos, deve excluir o webhook das configurações.


Existe uma hipótese onde ocorre um bug na Clearsale Total, onde ela não fica flagada. Para corrigir isso, precisamos inserir o código a seguir em configurações adicionais:

clear_sale: 0 //desativa a ClearSale Start

clear_sale_enable_api: true //Ativa ClearSale Total

Indicamos inserir um código de cada vez, depois acesse ClearSale e verifique se a flag do total foi ativada de fato.

  • Erro no widget Clearsale página de pedido painel Vnda:

    Caso ocorra, a solução é aplicar esses settings nas configurações adicionais da loja:

    {
    "settings": {
    "clear_sale": "1",
    "clear_sale_api": "1",
    "clear_sale_enable_api": "true"
    }
    }


Respondeu à sua pergunta?