O PrincipiaPay é uma plataforma de pagamentos especializada no mercado de educação digital, utilizada por grandes nomes do infoproduto no Brasil. A empresa já financiou mais de R$ 2 bilhões em cursos e possibilitou o acesso de mais de 600 mil alunos ao ensino, oferecendo solução de boleto parcelado em até 24x que desbloqueiam vendas, especialmente para alunos que não possuem cartão de crédito ou saldo imediato no PIX.
Como integrar o PrincipiaPay com a Clint?
Para iniciarmos a integração com o PrincipiaPay, primeiro precisamos acessar a Clint e iniciar o processo de integração via webhook para copiar o link de integração gerado, que será utilizado na configuração do PrincipiaPay.
⚠️Atenção: Para acessar a área de webhook no PrincipiaPay, é necessário ter permissões de administrador na plataforma.
Na Clint
Na sua Clint, clique em "Mais" na barra superior e depois em "Integrações".
No modal que abrirá, clique em "+ Nova Integração" no canto superior direito.
Selecione "Webhook".
Clique em "Receber Webhook" e depois "Começar".
Nesta página, clique em "Negócio" e depois em "Criar ou atualizar". Em seguida, selecione a origem desejada para os negócios, atribua um nome à integração e, por último, copie o link gerado e clique em "Continuar".
Deixe essa página aberta no seu navegador e acesse o PrincipiaPay para iniciar a integração por lá.
No PrincipiaPay
Agora, devemos entrar no PrincipiaPay para dar sequência à integração com a Clint. Para isso, acesse com o seu login, e na página inicial da plataforma clique em "Configurações".
Clique em "Integrações".
Selecione "Webhooks".
Clique em "+ Criar webhook".
Na página que será exibida na lateral direita da plataforma, insira um nome para identificar a integração no PrincipiaPay, cole a URL gerada na Clint e selecione o tipo de evento que deseja receber na Clint, como, por exemplo, "Compras expiradas". Por fim, clique em "Criar webhook".
Na Clint
Agora, retornamos na Clint para finalizar a integração. Para isso, clique em "Continuar".
Realize o mapeamento do campos, lembrando que na esquerda são os campos conforme o PrincipiaPay, e na direita são o campos da Clint.
Confira abaixo algumas informações que são possíveis trazer do PrincipiaPay para a Clint:
Propriedade | Tipo | Descrição |
buyer.name | Texto | Nome do comprador. |
buyer.email | Texto | E-mail do comprador |
buyer.phone | Texto | Telefone do comprador (com DDD e sem DDI) |
checkout.price | Texto | Valor total da venda |
Após realizar o mapeamento clique em "Continuar".
📌Importante: Para que a integração funcione corretamente e as informações sejam enviadas adequadamente para a Clint, é essencial que os campos do PrincipiaPay estejam configurados exatamente como descrito na tabela acima. Se precisar de informações mais específicas, entre em contato com o suporte da plataforma para obter auxílio no mapeamento.
Escolha a etapa em que deseja que os negócios provenientes do PrincipiaPay sejam criados, de acordo com a origem selecionada no início da integração. Defina também uma etapa para atualização e o status em que o negócio deve ser registrado na Clint. Caso deseje, você pode adicionar uma tag personalizada a esses negócios para facilitar a organização. Finalizando, clique em "Salvar".
E pronto, sua integração foi finalizada na Clint 🎉
Teste a integração
Para verificar se a integração está funcionando corretamente, retorne no PrincipiaPay e clique em "Teste de configuração".
Selecione "Enviar teste".
Agora, volte na Clint, acesse a origem em que realizou a integração e verifique se o negócio teste caiu corretamente na etapa.
Se o negócio com nome "John Doe" for criado, a integração está funcionando corretamente!
🚨Para cada evento que você deseja receber na Clint, como "Cartão recusado", "Abandono de carrinho" e outros, é necessário configurar uma integração separada, pois trata-se de uma integração via webhook. Recomendamos criar uma origem específica para cada evento que deseja receber na Clint e configurar uma integração individual para cada uma, selecionando o evento correspondente no PrincipiaPay, conforme descrito no passo a passo deste artigo.🚨