# Principia

### Como funciona a integração

Através desta integração, as compras realizadas serão liberadas na sua Área de Membros do Curseduca.

### Configurando a integração

Primeiramente, logue na plataforma <https://parceiro.stage.principia.net/> e crie um curso ou uma turma.

<details>

<summary>Como criar um curso ou turma na Principia?</summary>

Não sabe como criar um curso ou uma turma? Acesse o link da central de ajuda da Principia: <https://provicapital.notion.site/FAQ-Parceiro-3b809c2e22aa4c38b2246b23ec0927e6#ea41034db4b446159c92d8d042302fe1>

</details>

Caso você já tenha um curso ou turma criados, siga o passo a passo para configurar a sua integração de pagamento com o Curseduca.&#x20;

Para iniciar, acesse seu ambiente como instrutor ou administrador e clique no botão <mark style="color:blue;">**Grupo de acesso,**</mark> conforme imagem abaixo:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FdbuKncWFo4TCsZkwt622%2Fimage.png?alt=media&#x26;token=2672f2a3-5afa-4141-93e1-d996d094c1be" alt=""><figcaption><p>Home</p></figcaption></figure>

Em seguida, seremos direcionados para a página <mark style="color:blue;">**Grupo de acesso**</mark> e, devemos clicar escolher o Grupo a qual desejamos integrar, conforme mostra a imagem:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FBN00Gs5QmTDvPBfSmiNP%2Fimage.png?alt=media&#x26;token=04618f89-c675-451b-b9d6-6fc3cb8a87df" alt=""><figcaption><p>Home > Grupo de acesso </p></figcaption></figure>

Na mesma aba, vamos editar o grupo escolhido. Para isso, basta clicar no botão, conforme mostra a imagem:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FEmp4FG3VqTsw8KUeIVu1%2Fimage.png?alt=media&#x26;token=bb25729f-2945-4d57-ada0-f92e8a3bcae6" alt=""><figcaption><p>Home > Grupo de acesso > editar </p></figcaption></figure>

Em seguida, a aba de "**editar grupo de acesso**" se abrirá e você irá clicar em <mark style="color:blue;">**integrações**</mark>, conforme mostra:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FfdAHOfWIg0rF2SCmFlqK%2Fimage.png?alt=media&#x26;token=ae1e442e-bfad-4ba0-adb0-2373109ee6ba" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Agora, vamos <mark style="color:blue;">**+Adicionar nova integração**</mark> clicando no botão:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FetrDcNxxhU67WlcrPCtU%2Fimage.png?alt=media&#x26;token=49ae3995-38d7-4a83-b9fc-54dbc24ad01a" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Em seguida copiaremos a "URL do Webhook" da plataforma escolhida, no caso, a **Principia**. De acordo com o print:

{% hint style="info" %}
Dica: Você pode reservar a URL copiada, em um bloco de notas. Pois utilizaremos no próximo passo.
{% endhint %}

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FOjhBSPpvo09V7kDfMG42%2Fimage.png?alt=media&#x26;token=a6b0b87c-db6a-4a0f-98b6-c452b836fd7b" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Depois de copiar a URL do Webhook, clique em <mark style="color:blue;">**+Adicionar integração ao grupo de acesso**</mark>, conforme a imagem:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2Fuxq7WlRL1v8y1mlhuAZS%2Fimage.png?alt=media&#x26;token=e8da6570-3e3b-4779-9693-ab562a23b29d" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Pronto, a primeira parte da integração foi feita.&#x20;

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FLANtQgOHFXW2RM268FpJ%2Fimage.png?alt=media&#x26;token=54b54f25-eb99-4998-ab01-b5c009eaf732" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Agora, vamos configurar a Webhook da Principia!

### Principia - Configuração do Webhook&#x20;

Agora,  abra uma outra aba e logue na plataforma da Principia. No menu a esquerda, clique em 'Configurações'

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FzqoOrKBdEKGRqQ6KjZXi%2Fimage.png?alt=media&#x26;token=ee64ee31-997c-404d-84e1-d3c24bea76d5" alt=""><figcaption><p>Principia</p></figcaption></figure>

Em seguida, clicamos no menu superior em 'Integrações'

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F251qJKu13iHKt0dtUxur%2Fimage.png?alt=media&#x26;token=d6a8cd04-b441-4ce0-b930-04dea655a512" alt=""><figcaption><p>Principia</p></figcaption></figure>

Agora, selecionamos 'Webhooks', conforme a imagem:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2Fnsup2LLFiucjkbtZzaTw%2Fimage.png?alt=media&#x26;token=693cb866-f1c1-4254-bac7-ccffe46e34ab" alt=""><figcaption><p>Principia</p></figcaption></figure>

Após isso, basta selecionar a opção de **'+criar webhook'**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FsXG1GOtu8JSS558pXTbf%2Fimage.png?alt=media&#x26;token=c501cf6e-6fc1-4afe-9a60-9f21f0488877" alt=""><figcaption><p>Principia</p></figcaption></figure>

Agora, você irá preencher os seguintes campos

* **Nome:**  Escolha um nome da sua preferência
* **URL** : Aqui, é a URL do webhook que copiamos na página do <mark style="color:blue;">**Curseduca**</mark>, lembra?
* **Token de autorização:** não há necessidade de preenchimento
* **Eventos:** São as eventualidades que podem ocorrer e que fará com que a Principia envie uma notificação ao <mark style="color:blue;">**Curseduca**</mark>, selecione **'TODOS'**

Por fim, clique em **'Criar Webhook'**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FQkQgflLcMxt9qxhq2l8A%2Fimage.png?alt=media&#x26;token=e11fac08-e4a4-49b9-aa64-1f665d983bdd" alt=""><figcaption><p>Principia</p></figcaption></figure>

Feito isso, agora vamos liberar o produto comprado. Certo?

***

### Integração do produto

Seu membro fez uma compra na Principia e agora você precisa liberar este produto? Certo, aprenda aqui o passo a passo.

Ainda na plataforma da Principia, no menu à esquerda, vamos em '**Cursos e Turmas'**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2Fu66dmKhhlcvrvbc4X2kZ%2Fimage.png?alt=media&#x26;token=aec2c0e0-b0ac-4c2a-b77e-5e8b3017d8e7" alt=""><figcaption><p>Principia</p></figcaption></figure>

Selecione a turma que você deseja vincular  e copie o ID dela

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FJnHUAX68Ba0iFD6MoK2u%2Fimage.png?alt=media&#x26;token=d29571e2-7bb8-4030-ad99-5c34ce7560f9" alt=""><figcaption><p>Principia</p></figcaption></figure>

Após pegar este código, iremos configurar dentro do produto correspondente no <mark style="color:blue;">**Curseduca**</mark>, abaixo explicaremos detalhadamente este passo a passo.

### Curseduca - Configuração do Produto

Agora vamos cadastrar a ID do **conteúdo** no <mark style="color:blue;">**Curseduca**</mark>**!**

Vamos voltar lá na tela de integrações de Grupo de acesso do <mark style="color:blue;">**Curseduca**</mark>, conforme a imagem:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FLANtQgOHFXW2RM268FpJ%2Fimage.png?alt=media&#x26;token=54b54f25-eb99-4998-ab01-b5c009eaf732" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Vamos em <mark style="color:blue;">**+Adicionar referência externa**</mark>&#x20;

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FREKZqj66Ux87cylFQcoe%2Fimage.png?alt=media&#x26;token=d51bdff0-afa3-4097-850a-87a0ff8a1b40" alt=""><figcaption></figcaption></figure>

Agora, você irá incluir na <mark style="color:blue;">**referência externa**</mark> o código do **ID da turma**, que coletamos na página na Principia. Nesse caso, o código é `44162`.  Em seguida, clique em **'salvar'.** Conforme segue a imagem:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FdLC6Q8DKy4dEAeOXScfn%2Fimage.png?alt=media&#x26;token=e86d3e3f-44f4-483d-a816-ac25af90c00d" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Prontinho! Sua integração foi realizada.

{% hint style="danger" %}
Informamos que: não oferecemos suporte a este checkout para a compra de múltiplos produtos em uma única transação.
{% endhint %}

{% hint style="info" %}

#### **NOTA:** Todos os códigos e URLs são para exemplificação da Central de Ajuda. Nenhum código deve ser copiado diretamente da Central de Ajuda, cada plataforma tem o seu, por isso siga o passo a passo para obter o seu webhook e o código de produto.

{% endhint %}