# 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: 

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. 

#### 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. 

### 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&#x26;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&#x26;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&#x26;token=36790a4f-8780-4545-abd2-914cae9edc66" alt=""><figcaption></figcaption></figure>

### 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** e **Hubla**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FB9DDVA7M2YEycslQ5p6X%2Fimage.png?alt=media&#x26;token=cf469d58-a354-47a4-b2d0-36b5c5d0a34b" 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.

#### **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&#x26;token=c151328a-3d95-4853-a975-f796296385c6" 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&#x26;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&#x26;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&#x26;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 %}