Introdução
Conecte o Dodo Payments ao GoHighLevel (GHL) para vender pelos seus funis, sites, e-mails e SMS do GHL e processar pedidos com a automação do GHL. O GHL é uma plataforma de CRM e marketing com funis, sites, e-mail e SMS e automação (Workflows). O GHL não lista o Dodo Payments como processador de pagamentos integrado, então você conecta os dois de uma destas três maneiras. Escolha uma com base no nível de integração desejado para o checkout e na quantidade de código que você consegue escrever. Todas as abordagens lidam com o processamento da mesma forma: o Dodo Payments envia eventos de webhook para um workflow de Inbound Webhook do GHL, que adiciona uma tag ao contato, concede acesso e envia confirmações.Escolha sua abordagem
As três abordagens diferem no código necessário e no local onde o cliente paga:Pré-requisitos
Antes de começar, você precisa de:- Uma conta do Dodo Payments com pelo menos um produto.
- Uma conta do GoHighLevel com um funil, site ou workflow.
- Acesso a Developer → Webhooks no dashboard do Dodo Payments e a Developer → API Keys se precisar de uma API key.
- Para as abordagens B e C: um pequeno backend ou endpoint serverless que crie sessões de checkout.
Processamento com Webhooks (todas as abordagens)
O workflow do webhook é a camada de automação. Configure-o uma vez e ele funcionará com todas as abordagens de checkout.Create the Workflow
Add the Inbound Webhook Trigger
Register the Webhook in Dodo Payments
Add Fulfillment Actions
Abordagem A: Payment Links (sem código)
Adicione um link de pagamento do Dodo Payments a qualquer botão do GHL, chamada para ação do funil, botão da página de pedido, e-mail ou SMS. Os clientes pagam no checkout hospedado do Dodo Payments. Para saber o que o checkout oferece, consulte Recursos do Checkout.Create a Product and Copy Its Payment Link
https://checkout.dodopayments.com/buy/{product_id}.Add the Link to Your GHL Button
Set a Success Page (Optional)
redirect_url.Abordagem B: Overlay Checkout (código personalizado)
A abordagem B abre o checkout do Dodo Payments como um modal overlay na página do GHL, usando o Checkout SDK de uma CDN. Ela precisa de um backend que crie uma sessão de checkout e retorne seucheckoutUrl.
Create a Backend Endpoint That Calls the Checkout Sessions API
checkout_url.Exemplo de lógica do handler, para adaptar à sua plataforma:DODO_PAYMENTS_API_KEY da plataforma na qual fará o deploy e nunca faça commit dela no código. Permita solicitações do seu domínio do GHL (CORS) e disponibilize o endpoint em um domínio sob seu controle, por exemplo https://api.example.com/create-checkout. Quando passar para o modo live, altere a URL para https://live.dodopayments.com/checkouts.Add a Custom Code Element in the GHL Page Builder
- Clique no ícone + no canto superior esquerdo do builder para abrir Quick Add.
- Selecione Elements na lista de categorias à esquerda.
- Encontre Custom Code (também exibido como HTML) e arraste-o para a página.
- Cole o código abaixo no editor de código do elemento e salve.
Publish and Test on Your Domain
Abordagem C: Inline (incorporado) Checkout
A abordagem C incorpora o formulário de checkout dentro da página do GHL, sem redirecionamento nem popup. Ela usa o mesmo SDK com um elemento de contêiner no qual o checkout é montado. Assim como a abordagem B, precisa de um backend para criar a sessão.Create a Backend Endpoint That Calls the Checkout Sessions API
{ checkoutUrl }.Add a Container and SDK via Custom Code
- Clique no ícone + no canto superior esquerdo do builder para abrir Quick Add.
- Selecione Elements na lista de categorias à esquerda.
- Encontre Custom Code (também exibido como HTML) e arraste-o para a página, no local em que deseja exibir o formulário de checkout.
- Cole o código abaixo no editor de código do elemento e salve.
Verify Your Domain for Wallets (Apple Pay)
/.well-known/apple-developer-merchantid-domain-association. Em páginas hospedadas pelo GHL, use o hosted checkout do Payment Links (Approach A) ou não use o Apple Pay.Eventos a serem tratados
Inscreva o endpoint do GHL nos eventos usados pelo seu workflow. A tabela sugere uma ação do GHL para cada evento:data.customer.email. Use a ação find/create contact by email do GHL para associar o pagamento ao contato correto. Para cada evento, consulte o Webhook Event Guide.
Testes e entrada em produção
Test in Test Mode
4242 4242 4242 4242 (validade 06/32, CVV 123) e confirme que o workflow do GHL é executado e aplica a tag ou concede o acesso.Go Live
- Payment Links (A): Substitua o link pelo link de pagamento live do produto.
- Overlay checkout (B): Aponte seu backend para
https://live.dodopayments.com/checkoutsusando sua chave de API live e definamodecomo"live"na chamada INLINE_CODE_PLACEHOLDER_f5db7a37f0e5ebbcf_END do SDK. - Inline checkout (C): Faça as mesmas alterações do overlay checkout, pois ele usa o mesmo endpoint do backend e a mesma inicialização do SDK.
Dicas
Solução de problemas
Payment succeeded but nothing happened in GHL
Payment succeeded but nothing happened in GHL
Contact not created or not matched
Contact not created or not matched
Payment isn't showing in GHL's Payments tab
Payment isn't showing in GHL's Payments tab