# Stripe

## Introdução

Através desta integração, as compras realizadas na **Stripe** serão liberadas na sua Área de Membros. Caso haja um estorno, a matrícula deste aluno será Revogada na sua Área de Membros.

## Stripe - Chave API

O primeiro passo é adicionar a **chave de API** do **Stripe** no **Curseduca,** assim quando uma compra é concluída ou reembolsada o **Stripe** notificará o **Curseduca**.

Navegue para a seção **Desenvolvedores,** depois clique na aba **API keys**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2Fgl1ftbYL8N84QkQ4zBux%2Fimage.png?alt=media&#x26;token=3af1be56-792d-4178-893b-2e9f826b12ca" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Clique no botão **Revelar chave de teste** para mostrar sua **API KEY Stripe**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FYEy5X8PSGANx9hMIPfPy%2Fimage.png?alt=media&#x26;token=5449d2c0-58ff-4317-bdee-aa6e72745595" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

O **Stripe** irá abrir sua chave, copie-a para salvá-la na sua plataforma Curseduca

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FzTkK6dwWcXqik9zDe8zO%2Fimage.png?alt=media&#x26;token=24ec3b3a-6611-4145-8a8b-e46d1d38fe0c" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Prontinho, agora que você pegou sua **API KEY**, nos configuraremos ela no Curseduca.

## Curseduca - Integração

Na Home da plataforma, vá para a aba de configurações:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FVRMWNCBGyrnOLsuI6Vg8%2Fimage.png?alt=media&#x26;token=46ba60cf-1336-49b8-95cd-fb7b440e1218" alt=""><figcaption><p>Home</p></figcaption></figure>

Agora vá em **configurar integrações**, 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%2FDOMoGDgzCespHPRS0SRv%2Fimage.png?alt=media&#x26;token=570517bc-6fd3-4522-a5f7-199889c2ad1b" alt=""><figcaption><p>Home>configurações</p></figcaption></figure>

Agora selecionamos a **Stripe**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F7U1dd5ARey4GmlwVoeJK%2Fimage.png?alt=media&#x26;token=8723a3fe-7f8a-4a6f-b82e-cf514c1fadaf" alt=""><figcaption><p>Home>configurações>integrações</p></figcaption></figure>

Cole sua chave no campo **Api Key Stripe** e em seguida clique no botão **Salvar**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FElfGzI1pYNW6nYiHV9hg%2Fimage.png?alt=media&#x26;token=decdb35b-465b-45e9-8c36-a979efc3f13f" alt=""><figcaption><p>Home>configurações>integrações</p></figcaption></figure>

## **Stripe - Configuração**

### **Stripe - Criar endpoint para webhook**

Na **Stripe**, na seção **Desenvolvedores** clique na aba **Webhooks:**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FSGbLB7zYfMUg6yjZyCs8%2Fimage.png?alt=media&#x26;token=9269ce1a-8e0b-4a6c-af40-4cbfbb345cff" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

logo em seguida clique no botão **Adicione um endpoint**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F1WMn6r9xNpRHIdiLd2g1%2Fimage.png?alt=media&#x26;token=04ba8aa8-b75b-494d-ad19-1c339efc8ae5" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

A primeira informação a ser preenchida é a **URL** que o **Stripe** mandará as informações dos pagamentos.

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F74UIM70B0Boe9kdXO3Wa%2Fimage.png?alt=media&#x26;token=dc339b6d-374c-40e8-a927-56d5ce870d78" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Na sua plataforma **Curseduca** entre no mesmo local onde você inseriu a **API KEY Stripe Configurações** -> **Integrações** -> **Stripe**

Clique no botão **Copiar** para você capturar a **URL** **de** **Webhook**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FIP3zJgwvTvNtyOCxlgra%2Fimage.png?alt=media&#x26;token=3c89da6c-a7a8-4149-8121-293a450c6b92" alt=""><figcaption><p>Home>Configurações > Integrações > Stripe</p></figcaption></figure>

Insira essa **URL** na configuração do **Webhook** no **Stripe**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2Fz6gA9D0B96VlgJgW2Gm9%2Fimage.png?alt=media&#x26;token=9e274ae3-1d34-4cd0-a760-03061fbe3c19" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Clique no botão **Selecionar eventos:**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FZgmbwlEl8nBeZvbQS8sk%2Fimage.png?alt=media&#x26;token=49820fed-1d2c-4925-9df5-1cec24739358" alt="" width="563"><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Uma tela será aberta para você selecionar os eventos que o **Stripe** irá avisar à sua plataforma **Curseduca.** Esses eventos são referentes a forma de pagamento, cartão de crédito e boleto. Indicamos que selecione **todos os eventos.**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FwFZD5n0dpHs5HVigYJUe%2Fimage.png?alt=media&#x26;token=13bd189f-b431-4c54-9f4d-eada4c310a50" alt="" width="563"><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Selecione os eventos e clique no botão **Adicionar eventos** para adicionar os eventos.

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FTHItQJaKRZOdX5HMSA0d%2Fimage.png?alt=media&#x26;token=c7324487-33a1-40c4-be85-0c8580634cfe" alt=""><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Agora salve essa configuração clicando no botão **Adicione um endpoint:**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FjCKI7rbpPrPbyOB86Zb8%2Fimage.png?alt=media&#x26;token=20fd9881-d900-4c3c-ad44-4ba33c9e2c9a" alt="" width="563"><figcaption><p><strong>Stripe</strong></p></figcaption></figure>

Prontinho, seu **Webhook** foi configurado na **plataforma** **Stripe** e **Curseduca**, agora iremos criar e configurar o conteúdo.

### Stripe - Criação de produto

Após configurar o **Webhook** criaremos um produto na Stripe, para isso navegue para a seção **Produtos** e clique no botão **Adicionar** **produto:**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FQnS8q1s1aMwQnbZt1Z1H%2Fimage.png?alt=media&#x26;token=aab0d58e-8739-4f75-8927-ee8988d6da98" alt="" width="191"><figcaption><p>Stripe</p></figcaption></figure>

Preencha as informações do produto, inserindo:

Nome: Fica a sua escolha.                                                                                                                                          Descrição: Um breve resumo do que se trata o curso/produto                                                                                      Imagem: Foto para ilustrar o produto                                                                                                                                            Modo de pagamento: Recorrente ou avulso ( Agora o <mark style="color:blue;">**Curseduca**</mark> te dá suporte nos dois modos)                                       Valor (obrigatório): Defina o preço do seu produto.  (Não pode ser gratuito)

{% hint style="info" %}
⚠️ Seu produto precisa ter um valor. Caso você coloque R$0,00 a integração não irá reconhecer a venda e dará uma falha. Como se trata de uma integração de venda é necessário ter um valor. (A API da Stripe não identifica a gratuidade).

Caso você queira deixar o produto gratuito, você pode liberá-lo pela Curseduca, sem a necessidade da integração.
{% endhint %}

Período de faturamento: Defina o período a qual você deseja receber

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FmfeuLiBJB2sOKpVSzgOP%2Fimage.png?alt=media&#x26;token=32dcf271-d319-4835-a9c0-58a773c40756" alt="" width="503"><figcaption><p>Stripe</p></figcaption></figure>

Após isso clique no botão no canto inferior direito **Adicionar Produto** para salvar o produto.

{% hint style="info" %}
**Importante:** Agora o <mark style="color:blue;">**Curseduca**</mark> dá suporte para pagamentos avulsos e recorrentes!
{% endhint %}

Agora você deve clicar no produto criado para ser redirecionado a tela do produto:

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F4JMJ8osEP9mXTOsg5xpp%2Fimage.png?alt=media&#x26;token=2f0cc96e-e41a-4d85-9648-89e15f564ea0" alt=""><figcaption></figcaption></figure>

Em seguida você pegará o código que será usado para a integração de um produto **Stripe** a plataforma <mark style="color:blue;">**Curseduca**</mark><mark style="color:blue;">.</mark> Copie o código clicando sobre ele.

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F6fe5kp9e5M1hkDC7MFLN%2Fimage.png?alt=media&#x26;token=37b60c2b-04b8-40b9-9015-44e31546a417" alt=""><figcaption><p>Stripe</p></figcaption></figure>

O próximo passo é criar um link de pagamento para este produto. Este link você enviará para os seus clientes comprarem o seu produto. Sendo assim, clique no botão **Criar link de pagamento** na área destacada, 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%2F8gnxB9eYHuhgCdl8yyUP%2Fimage.png?alt=media&#x26;token=c2854b9a-7c00-4c5b-944f-0865a5a98513" alt=""><figcaption><p>Stripe</p></figcaption></figure>

A tela a seguir será aberta, para você configurar os itens de compra que estarão no checkout.&#x20;

{% hint style="danger" %}
É importante que na hora de fazer o link de pagamento você coloque apenas um produto por checkout na integração, como também a quantidade do produto deve ser 1.
{% endhint %}

Em seguida clique em **Criar link**

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FDhFqgkRqhGaZWo6HuWpK%2Fimage.png?alt=media&#x26;token=2b4b44ca-6d7a-4521-a3ef-46f23be113b3" alt=""><figcaption><p>Stripe</p></figcaption></figure>

Para copiar o link do checkout de pagamento deste produto, clique no botão **Copiar** destacado na imagem.

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F49NIekU0MJYlLt0LHguI%2Fimage.png?alt=media&#x26;token=993d8bf0-9514-4e9f-8e09-937003acf7c2" alt=""><figcaption></figcaption></figure>

Com o código do produto **Stripe** em mãos, você deverá entrar na sua plataforma **Curseduca** para configurar o produto que será integrado.

## Curseduca - Configuração do produto

### Curseduca&#x20;

Após criar o ***WebHook*** na **Stripe**, precisamos cadastrar o ID do conteúdo da ***Stripe*** no **Curseduca**.

Acesse seu ambiente como instrutor ou administrador e clique no botão <mark style="color:blue;">**Grupo de acessos,**</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%2FFDePEcoav4FbkiN4XX1o%2Fimage.png?alt=media&#x26;token=b2e5eb64-aa58-45e6-aa31-80ed5dd32e97" alt=""><figcaption><p>Home</p></figcaption></figure>

Em seguida, seremos direcionados para a página <mark style="color:blue;">**Grupo de acessos**</mark> e, devemos clicar escolher o Grupo/turma 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>

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%2FQCdjNWvm51bKBnrKUeSU%2Fimage.png?alt=media&#x26;token=2ce54c12-d412-42d3-ac5b-9167d85369f8" alt="" width="563"><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Em seguida, clique na <mark style="color:blue;">**setinha**</mark> ao lado da Integração, conforme mostra a imagem e 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%2FxgHBGlllqaKj7nWE1y5E%2Fimage.png?alt=media&#x26;token=fbddf812-bcf7-40e8-bee2-48524f1f9e30" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Agora, você irá incluir na <mark style="color:blue;">**referência externa**</mark> (o número coletado no código do produto da Stripe). Conforme segue a imagem, e depois clique em **salvar**.

<figure><img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2FFz8xW0F5524X3kULOj2F%2Fimage.png?alt=media&#x26;token=825cd0cb-42cb-40c8-beb9-cefead630f40" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

<details>

<summary>Lembrete: código do produto da Stripe</summary>

Caso você tenha esquecido como achar o código da referência externa basta ir no produto criado na Stripe e, o ID estará na parte superior, na lateral direita. Conforme imagem:

&#x20;                                               <img src="https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2F2A5shXyPbkOEqphqUwAD%2Fimage.png?alt=media&#x26;token=78f06e60-2daf-44f8-bbc5-aef74aab9aef" alt="" data-size="original">

&#x20;                                                      ![](https://2164836145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtoLBvE-NBxibKO0U39%2Fuploads%2Fxt10Tyiz7fPAF28rUPb5%2Fimage.png?alt=media\&token=48e00fbe-693b-45c5-89e9-bc2bc362d7f3)

\*Este código é do produto teste criado pelo Curseduca para demonstração. Lemebre-se que, cada produto tem um código exclusivo.

</details>

***

{% hint style="danger" %}
Informamos que em alguns de nossos checkouts, é possível adicionar mais de um produto ao carrinho e finalizar a compra de todos os itens juntos. No entanto, o Curseduca não oferece suporte a essa funcionalidade na Stripe.
{% 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 %}