> For the complete documentation index, see [llms.txt](https://ajuda.ensinio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.ensinio.com/duvidas-frequentes-1/checkout-externo-integrando-com-outra-plataforma-de-vendas.md).

# Checkout Externo: Integrando com Outra Plataforma de Vendas

A Ensinio permite que você utilize o checkout de outra plataforma para processar suas vendas e, ao mesmo tempo, entregue o acesso ao conteúdo automaticamente na sua plataforma. Assim, você mantém a experiência de aprendizado na Ensinio sem abrir mão da receita de vendas em plataformas como Hotmart, Kiwify, Monetizze, entre outras.

### Antes de configurar a integração na Ensinio

Antes de configurar a integração aqui na Ensinio, é necessário configurar um webhook na plataforma externa para que ela envie notificações referentes aos eventos de quando um pedido for:&#x20;

1. **Aprovado** - *cria a inscrição e libera o acesso ao curso.*
2. **Reembolsado/Cancelado** - *bloqueia o acesso do aluno ao curso.*
3. **Sofrer um chargeback** - *bloqueia o acesso do aluno ao curso.*

Caso a venda seja por recorrência, selecione também os eventos de:

1. **Assinatura renovada** - *mantém o acesso ativo para cursos recorrentes.*
2. **Assinatura cancelada** - *cancela uma recorrência.*

No caso de uma venda, o webhook é necessário para que  a Ensinio não precise ficar perguntando a cada segundo à plataforma de checkout se "tem venda nova? ". O checkout externo (quando configurado corretamente) **envia uma notificação automática** (o webhook) para a Ensinio assim que o pagamento é aprovado.&#x20;

#### Exemplo de um fluxo de integração:

1. **Evento:** Um aluno compra seu curso no checkout externo.
2. **Gatilho (Webhook):** A plataforma de checkout detecta a compra aprovada e envia os dados (dados do usuário como nome, e-mail e o curso comprado) para uma [URL específica da Ensinio](#url-de-postback).
3. **Ação da Ensinio:** A Ensinio recebe essa informação e cria o usuário, libera o acesso ao curso e, muitas vezes, envia os dados de login para o aluno automaticamente.&#x20;

### Acessando os Checkouts Externos

1. No "**Admin Console"**, clique no ícone "**App Store"** no menu lateral esquerdo.
2. Clique em **"Checkouts externos".**
3. **Clique em "+ Criar uma integração externa".**

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FEEAdVNBtG10mbOQHEpYX%2Fimage.png?alt=media&amp;token=dbf72c27-a6f4-4b79-97c0-8c58f1250aea" alt=""><figcaption></figcaption></figure>

4. Uma janela será exibida com informações sobre a funcionalidade. Leia o aviso e clique em **"Entendi, quero continuar"** para prosseguir.

{% hint style="warning" %}
A notificação de criação de acesso pode levar entre 3 e 7 minutos após a compra ser aprovada na plataforma externa. Se quiser que o acesso seja imediato, considere criar a oferta diretamente na Ensinio.
{% endhint %}

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FgrMopnT1H0rjD8nnDsnB%2Fimage.png?alt=media&amp;token=3362ad27-3e07-492a-9410-2386b121aeae" alt=""><figcaption></figcaption></figure>

### Configurando a entrega

Após clicar em **"Entendi, quero continuar"**, você será direcionado para a tela **"Criando uma entrega"**.

1. No campo **"Nome da entrega"**, digite um nome para identificar essa integração.&#x20;

   Exemplo: *Hotmart - Curso de Marketing*.
2. No campo **"Código do produto na plataforma"**, insira o código do produto correspondente na plataforma externa. Esse código é fornecido pela plataforma que você escolher.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FdpbLVSW62T22EljTdrx1%2Fimage.png?alt=media&amp;token=36790a4f-8780-4545-abd2-914cae9edc66" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Uma particularidade é que no caso da Asaas, nesse campo aqui na Ensinio deve ser adicionada a "Descrição da cobrança" criada na plataforma de vendas.
{% endhint %}

#### Selecionando a plataforma

Na seção **"Selecione a plataforma"**, clique na plataforma que você utiliza para processar suas vendas.

As plataformas disponíveis atualmente são: **Hotmart, Kiwify, Ticto, Monetizze, Lastlink, Greenn, Digital Manager Guru, Asaas, PagBank, Payt, Appmax, Zouti, Eduzz,** **Hubla, TMB e Lia**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FLnk3S5LoQjiGLy9m6wKq%2Fimage.png?alt=media&amp;token=1661ba80-3915-4c4b-93fe-c785129594ed" alt=""><figcaption></figcaption></figure>

### Como configurar a integração na Ensinio <a href="#como-configurar-a-integracao-na-ensinio" id="como-configurar-a-integracao-na-ensinio"></a>

Ao clicar em Criar integração e selecionar a plataforma de vendas serão exibidos campos de preenchimento obrigatório e um link da URL de Webhook/Postback.

Abaixo segue uma tabela explicativa resumida com todos esses campos, inclusive "**Nome de entrega**" e "**Código do produto na plataforma**", já mencionados nesta [seção](#configurando-a-entrega).

<table><thead><tr><th width="173">Campo</th><th width="191">Onde encontrar/gerar</th><th>Onde colar</th><th>Para que serve</th></tr></thead><tbody><tr><td>Nome da entrega</td><td>Você  define esse nome. Serve apenas para reconhecimento interno.</td><td>Direto no campo "Nome da entrega", na integração da Ensinio</td><td>Identificar essa integração dentro do painel da Ensinio</td></tr><tr><td>Código do produto na plataforma</td><td>É o código do produto correspondente obtido na plataforma externa. </td><td>No campo "Código do produto na plataforma", na integração da Ensinio</td><td>Conectar a cobrança da plataforma de vendas ao produto correspondente na Ensinio</td></tr><tr><td>URL de Webhook/Postback</td><td>Gerada automaticamente pela Ensinio ao criar a integração</td><td>No campo "URL" do webhook configurado na plataforma de vendas</td><td>Permite que a plataforma de vendas envie as notificações de pagamento para a Ensinio</td></tr><tr><td>Token de autenticação*</td><td>Gerado no webhook configurado na plataforma de vendas</td><td>No campo "Token de autenticação", na integração da Ensinio</td><td>Autenticar as notificações recebidas, confirmando que vêm da plataforma de vendas</td></tr><tr><td>Chave da API*</td><td>Gerada no painel da plataforma de vendas</td><td>No campo "Chave da API", na integração da Ensinio</td><td>Permitir que a Ensinio se comunique com a conta na plataforma de vendas</td></tr></tbody></table>

{% hint style="success" %}
\*  O campo "Chave da API" e "Token de autenticação" são exigidos na integração de apenas algumas plataformas.\
\
**Exemplos**:&#x20;

Hotmart - exige apenas o Token de autenticação.

Asaas - exige o Token de autenticação e a Chave da API.

Kiwify e Eduzz - NÃO exigem o Token de autenticação e nem a Chave da API.<br>
{% endhint %}

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Fwsl7ruKCG8ee1FmzgHcr%2Fimage.png?alt=media&amp;token=d0be12ab-a313-49d1-8bfc-7bd33222f678" alt=""><figcaption></figcaption></figure>

#### **URL de postback**

Ao selecionar uma plataforma será exibida a  **URL de postback.**

A URL exibida é o endereço de webhook da sua plataforma Ensinio. Copie esse link e cadastre-o na plataforma externa escolhida — geralmente em **Configurações > Webhooks** ou similar. É por meio dessa URL que a plataforma externa saberá onde notificar a Ensinio quando uma venda for aprovada, reembolsada ou cancelada.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FQ7jKz39SfwVFUeLn1sLd%2Fimage.png?alt=media&amp;token=69ec9e02-04db-48c3-80b8-c52f458086f8" alt=""><figcaption></figcaption></figure>

#### **Token de autenticação**

Ao clicar em ALGUMAS plataformas será exibido também um campo para acrescentar um **token de autenticação**. &#x20;

O token solicitado aqui é gerado pela **plataforma externa**. Acesse as configurações da plataforma que você escolheu — geralmente em **Configurações > API** ou **Tokens** — copie o token disponibilizado lá e cole neste campo. Ele garante que apenas a plataforma autorizada consiga enviar notificações para a sua plataforma.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FUcOGgEBCLEYVwwqj3tcs%2Fimage.png?alt=media&amp;token=c151328a-3d95-4853-a975-f796296385c6" alt=""><figcaption></figcaption></figure>

### Chave da API

Ao clicar em ALGUMAS plataformas será exibido também um campo para acrescentar uma Chave de API. &#x20;

Essa chave é obtida na plataforma de vendas e colada no campo especificado na página de integração aqui na Ensinio.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FLytY0BCt9VUqszVeKTP4%2Fimage.png?alt=media&amp;token=df0f499a-8576-4f44-87d2-c884bb534b0e" alt=""><figcaption></figcaption></figure>

### Configurando a expiração da inscrição

Na seção **"Expiração da inscrição"**, você define por quanto tempo o usuário terá acesso ao conteúdo após a compra.

* Se o acesso for **vitalício**, mantenha a opção **"Habilitar expiração da inscrição"** desativada.
* Se o acesso for **por tempo limitado**, ative a opção e defina o período de acesso.

{% hint style="success" %}
Essa configuração é recomendada para vendas de pagamento único quando o checkout externo não envia a data de expiração do acesso automaticamente.
{% endhint %}

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FiUnyqXrM2yRWlbwgQfvq%2Fimage.png?alt=media&amp;token=e051b21d-0a6e-47ee-bc95-1a1b99f83af6" alt=""><figcaption></figcaption></figure>

### Selecionando o grupo que o usuário receberá acesso

1. Na seção **"Grupo que o usuário receberá acesso"**, clique em **"+ Selecionar grupo"**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FUXQ9BcnwyzpkSMv4mO3z%2Fimage.png?alt=media&amp;token=df0f9a9d-b8c5-42ee-badf-3d84cef8685c" alt=""><figcaption></figcaption></figure>

2. Escolha o grupo ao qual o usuário deverá ter acesso após a compra ser confirmada pela plataforma externa.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FTKpV3jOx92yPuzgHnDR8%2Fimage.png?alt=media&amp;token=800a2549-560c-4bcb-ae59-4a75c33caa35" alt=""><figcaption></figcaption></figure>

Com tudo preenchido, clique em **"Salvar",** no canto superior direito, para concluir a configuração.

{% hint style="success" %}
Você pode criar mais de uma entrega para o mesmo grupo caso  o mesmo produto seja vendido em plataformas diferentes.
{% endhint %}

### A integração funcionou? <a href="#a-integracao-funcionou" id="a-integracao-funcionou"></a>

Faça **testes de compra**, para verificar se o acesso será criado na Plataforma corretamente.

### Removendo uma integração de Entrega <a href="#removendo-uma-integracao-de-entrega" id="removendo-uma-integracao-de-entrega"></a>

Caso você não queira mais receber novos usuários a partir de vendas realizadas na Hotmart, você pode excluir a integração de Entrega na Ensinio. Desta forma, mesmo que a Hotmart envie para nós informações sobre novas compras, nós não iremos processar ou conceder acesso aos usuários notificados a nós pela Hotmart.

Note que notificações realizadas enquanto uma integração de Entrega não está ativa serão perdidas e não podem ser reprocessadas, você precisará recriá-las ou, se possível, re-enviar as notificações a partir da Hotmart para que o sistema receba todas e processe novamente.

1. Acesse o "**Admin Console"**.
2. Vá até "**App Store"** na barra lateral de navegação.
3. Clique em "**Checkouts externos"** para conferir as integrações.
4. Clique no ícone de lixeira no canto direito.
5. Confirme que você está ciente que a ação é irreversível clicando em "**Excluir integração"**.
6. Pronto, a integração está removida e sua área de membros não receberá novos usuários a partir desta Entrega via Hotmart.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FUZZC0mEOmeSK0eNRmrgK%2Fimage.png?alt=media&amp;token=718f6caf-7f45-4e97-808c-38989b0ad528" alt=""><figcaption></figcaption></figure>

### Checklist rápido: Checkout Externo (Geral)

**Antes de começar**

* [x] Defini na plataforma de vendas quais produtos vão liberar acesso na Ensinio
* [x] Mapeei se o acesso do produto será **vitalício** ou **por tempo limitado** (recorrência/expiração)

**Na Ensinio**

* [x] Acessei o **Admin Console** > **App Store** > **Checkouts externos**
* [x] Cliquei em **+ Criar uma integração externa** e depois em "Entendi, quero continuar"
* [x] Preenchi o **Nome da entrega** para identificação interna
* [x] Selecionei a **Plataforma de vendas** que vou utilizar
* [x] Copiei a **URL de postback** gerada automaticamente para cadastrar no webhook externo
* [x] Observei quais campos de validação apareceram (Apenas Token, ou Token + Chave de API) de acordo com a plataforma selecionada

**Na Plataforma de Vendas Externa**

* [x] Localizei e copiei o **Código/ID do produto** no painel de vendas
* [x] Criei um novo webhook/postback apontando para a **URL de postback** que copiei da Ensinio
* [x] Selecionei os eventos obrigatórios de checkout único: **Aprovado**, **Reembolsado/Cancelado** e **Chargeback**
* [x] Selecionei os eventos de checkout recorrente (se aplicável): **Assinatura renovada** e **Assinatura cancelada**
* [x] Gerei e copiei as credenciais de segurança exigidas pela integração (apenas o **Token de autenticação**, ou o **Token + Chave de API**)

**Finalizando na Ensinio**

* [x] Colei o código do produto no campo **Código do produto na plataforma**
* [x] Colei o **Token de autenticação** gerado na plataforma de vendas
* [x] Colei a **Chave da API**, caso a plataforma selecionada exija esse segundo campo
* [x] Configurei a **Expiração da inscrição** (se o acesso não for vitalício)
* [x] Cliquei em **+ Selecionar grupo** e defini qual grupo o aluno receberá acesso
* [x] Cliquei em **Salvar** no canto superior direito

**Por fim**

* [x] Fiz uma compra teste e aguardei de **3 a 7 minutos** para confirmar se o acesso do aluno foi liberado perfeitamente
