Skip to main content
Skip table of contents

Ativar Integração com PrincipiaPay

Ao integrar sua conta PrincipiaPay à Guru, você poderá processar os pagamentos dos seus clientes através do Checkout Guru e gerenciar todo o negócio através da nossa plataforma.

Para ativar a integração, você deve criar uma conta na PrincipiaPay, obter o token API e informá-lo na Guru. Depois de ativar a integração, você deve adicionar produtos e ofertas para obter links de checkout.


Nessa página:

  • Passo 1: Obter Token API

  • Passo 2: Ativar integração


Antes de começar, você precisa:

  • Ter uma conta de produção ativa na PrincipiaPay.

  • Ser usuário administrador ou ter permissão para realizar as ações a seguir.

Passo 1: Obter Token API

Nesta etapa, você deve acessar a página da PrincipiaPay e preencher o formulário de acesso para adesão a PrincipiaPay.

Etapas:

1 - Acesse sua conta PrincipiaPay com usuário e senha.

2 - No menu lateral, clique em Configurações e, em seguida, clique em Integrações.

principiapay-integrações.png

3 - Em Integrações, clique em API Token.

principiapay-api token.png

4 - Em API Token, copie e armazene o Token.

principiapay-copiar token.png


Passo 2: Ativar integração

Nessa etapa, você deve acessar sua conta Guru para a integração com a PrincipiaPay.

A chave API não ficará disponível depois de gravar a integração. Caso altere a chave API, a mesma não será válida, sendo necessário retornar ao ambiente PrincipiaPay para obter a chave.
Essa alteração trará maior segurança para a sua conta, não sendo possível visualizar os dados de integração.

Etapas:

1 - Acesse o admin da Guru com seu usuário e senha.

2 - Acesse Configurações > Integrações > Checkout Guru > PrincipiaPay.

checkout guru-principiapay.png

3 - Na aba Detalhe, informe:

  1. Token API: o token API - obtido do passo 1 - item 4;

  2. Ativo: mude o botão para a posição ligado.

principiapay-ativar.png
desligado - ligado.png

4 - Clique em Enviar.


O que fazer a seguir?

Uma vez que a integração com a PrincipiaPay está ativa, você deve acessar a seção Produtos para adicionar os produtos e suas respectivas ofertas.

Lembre-se de vincular o produto à PrincipiaPay (campo marketplace). Depois de adicionar uma oferta, o link de checkout estará disponível para divulgação.

Consulte o passo a passo completo:

Importe os produtos da sua loja virtual

Se você usa uma plataforma de e-commerce integrada à Guru, é possível importar os produtos da sua loja. Em seguida, atualize ou adicione uma oferta ao produto para gerar o link de checkout.

Informações adicionais sobre o cadastro de Produtos

Utilize nomes de produtos únicos na Guru para garantir o funcionamento correto da sua integração com a PrincipiaPay.

Ao configurar a PrincipiaPay como seu marketplace, certifique-se de que não haja dois produtos com o mesmo nome cadastrados na Guru.

Se tentar criar ou manter dois produtos com nomes idênticos vinculados à PrincipiaPay, ocorrerá um erro de sincronização ao tentar criar a conta ou processar a transação.

O valor mínimo para venda de um produto na PrincipiaPay é R$180,00. Caso seja necessário modificar esse valor, entre em contato com o gerente de contas da PrincipiaPay e solicite a mudança.


Mais Recursos

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.