> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.themembers.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como fazer a integração com o Kiwify?

Leia atentamente à este artigo para saber como realizar corretamente a integração com o gateway de pagamento. 
 
**Observações:**

**- Essa integração não comporta produtos de OrderBump.**

**- Não suporta período Trial.**

# PASSO 1.
O primeiro passo é a criação de produto no dashboard. É muito importante que o ID do produto seja informado corretamente. Caso ainda não tenha criado, siga este artigo: [Como criar um produto ou oferta na plataforma?](https://ajuda.themembers.com.br/pt-br/article/como-criar-um-produto-ou-oferta-na-plataforma-trmlmf/)

O ID de produto da Kiwify é informado no link da URL da edição do produto, logo após a barra, como na imagem.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip0_1d7y267.png =652xauto)
E então, no dashboard da TheMembers, o código será informado dentro do produto correspondente, como na imagem abaixo.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/imagem2025-09-11083223076_1hd4s2i.png)
# PASSO 2.
No painel da Kiwify, clique em Apps > Webhooks. 

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip2_15o2ciz.png =654xauto)
# PASSO 3.
Clique em Criar webhook.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip3_1qohc1i.png =697xauto)
# PASSO 4.
Na criação do webhook, em "Nome" coloque TheMembers.

Em URL do webhook, vamos colar o link coletado no dashboard da TheMembers em Plataforma > Configurações > Integrações > Kiwify 

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/imagem2025-09-11083315275_f6vqob.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/imagem2025-09-11083354983_19ggr10.png)
Clique em Testar Webhook.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip2-1_1h7jp0q.png =438xauto)
No envio de teste, na parte de Evento, selecione a opção Compra Aprovada e clique em Enviar Teste.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip3-1_1qczpha.png =464xauto)
Esse envio de teste é uma validação interna da ferramenta da Kiwify para confirmar que a URL de envio realmente está recebendo as informações necessárias para que a configuração seja válida.

* Esse envio de teste **NÃO GERA** nenhum log, json ou payload de webhook pois ele é apenas uma etapa de validação para confirmar a integração. As únicas transações que geram logs e podem ser consultadas em seu histórico são as reais como compra aprovada, chargeback, etc.

Após o teste ser validado, aparecerá uma mensagem na tela de Integração adicionada, como na imagem abaixo.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/k1_ts83gk.png =918xauto)
# PASSO 5.
Ainda na criação de webhook, na parte de Produtos, selecione "Todos que sou produtor" caso queira englobar todos os seus produtos presentes na Kiwify.

Obs: Caso seja um ou mais produtos específicos, será necessário criar um webhook para cada um. 

Em Evento, vamos selecionar os seguintes: Compra recusada, compra aprovada, reembolso, chargeback, assinatura cancelada, assinatura atrasada, assinatura renovada.

Clique em criar para finalizar a configuração. 

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip7_18f304o.png =480xauto)
# PASSO 6.
Com esses passos, a configuração da integração já estará funcionando. Nesse passo, vamos te mostrar como conferir se os eventos estão sendo disparados corretamente.

Ainda no painel da Kiwify, clique em Apps > Webhooks > Localize a URL da TheMembers e clique nos 3 pontinhos > Ver Logs

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip8_1jc9ipc.png =682xauto)
Os eventos (transações) estarão em lista nessa seção e em Status aparecerão um dos dois: Sucesso ou Falhou.

Detalhe: A Kiwify armazena o histórico apenas dos eventos dos últimos 7 dias, caso queira investigar um evento antes disso, procure o suporte da Kiwify para coletar o retorno do webhook.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip9_1c7sto8.png =804xauto)

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip11_13p7ptd.png =816xauto)
As que estiverem com Sucesso, significa que os alunos foram cadastrados e receberam o e-mail de acesso, ou suas assinaturas foram atualizadas (Canceladas ou renovadas). Em caso de Falhou, para saber o retorno do erro, é necessário clicar no ícone dos 3 pontinhos > Ver logs.
 
Para identificar qual é o retorno de erro, veja o texto informado no campo de "Resposta". Quando dá falha, geralmente são situações de: Código ID de produto incorreto ou o produto criado no dashboard da TheMembers não possui entregável.

Nesses casos, após realizar as devidas correções, é possível voltar no webhook que deu erro e clicar nos 3 pontinhos > Reenviar. 

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip10_aeg3r7.png =815xauto)

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip12_ftacm6.png)
