For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/stripe.md.
  • Português

      • Integrar Stripe

      Com a integração Stripe, as vendas da sua conta Stripe chegam ao ClickMax e criam ou atualizam o contato pelo e-mail do comprador. Ela também libera o bloco Checkout Stripe no editor de páginas, que precisa da chave publicável e do segredo de assinatura do webhook.

      Antes de começar

      • Você precisa de acesso à área Desenvolvedores da sua conta Stripe.
      • As duas chaves precisam ser do mesmo modo: as duas de produção (live) ou as duas de teste (test).

      Passo a passo

      1. Crie a chave restrita na Stripe

      1. Na Stripe, abra Desenvolvedores → Chaves de API e clique em Criar chave restrita.
      2. Em Escolha como esta chave será usada, selecione Compartilhamento com um serviço externo.
      3. Preencha:
        • Nome do fornecedor: ClickMax;
        • URL: https://clickmax.io.
      4. Em Atribuir permissões à sua chave, escolha Standard. Ela já inclui tudo o que o ClickMax usa: criar o checkout, listar preços e produtos e receber pagamentos, reembolsos e disputas.
      5. Crie a chave e copie o valor (começa com rk_).

      2. Crie a integração no ClickMax

      1. No ClickMax, abra Integrações, escolha Stripe e cole a chave em Chave secreta ou restrita.
      2. Na Stripe, em Desenvolvedores → Chaves de API, copie a Chave publicável (começa com pk_) e cole em Chave publicável.
      3. Dê um apelido à integração, defina o status e clique em Criar integração.
      4. Copie a URL do webhook que o ClickMax mostra.

      3. Cadastre o webhook na Stripe

      1. Na Stripe, abra Webhooks → Adicionar destino e selecione os eventos:
        • checkout.session.completed
        • checkout.session.async_payment_succeeded
        • checkout.session.async_payment_failed
        • invoice.payment_succeeded
        • invoice.payment_failed
        • charge.refunded
        • charge.dispute.created
        • charge.dispute.closed
      2. Escolha Endpoint de webhook, cole a URL do ClickMax e clique em Adicionar destino.
      3. Abra o destino criado e copie o Segredo de assinatura (começa com whsec_).
      4. Volte ao ClickMax, cole o segredo em Segredo de assinatura do webhook e clique em Concluir integração.

      Com o segredo de assinatura, o ClickMax só aceita webhooks enviados pela sua conta Stripe.

      O que chega no ClickMax

      Na StripeNo ClickMax
      Pagamento aprovadoVenda paga, com o valor total e a moeda da Stripe
      Boleto, débito ou outro pagamento que confirma depoisVenda pendente; vira paga quando a Stripe confirma, ou com falha se o pagamento não for concluído
      AssinaturaUma venda por fatura paga. A primeira fatura e o checkout que a gerou contam como uma venda só. Uma cobrança recusada aparece com falha e vira paga se a Stripe conseguir cobrar depois
      Reembolso totalA venda passa para reembolsada e sai da receita. Reembolso parcial mantém a venda paga
      Disputa (chargeback)A venda passa para chargeback. Se você ganhar a disputa, ela volta a paga

      Itens extras do mesmo pedido aparecem como produtos adicionais da venda.

      Se não funcionou

      • O campo fica marcado em vermelho: a chave colada não é do tipo pedido. A secreta começa com sk_, a restrita com rk_, a publicável com pk_ e o segredo de assinatura com whsec_.
      • Aparece Erro ao criar integração (ou Erro ao concluir integração): confira se:
        • as duas chaves são do mesmo modo (as duas de produção ou as duas de teste);
        • a chave restrita foi criada com as permissões Standard;
        • a chave não foi apagada ou trocada na Stripe.
      • Os preços não aparecem no editor ou o checkout não carrega: a chave restrita foi criada sem alguma permissão. Na Stripe, abra a chave, clique em Editar nas permissões e use Standard.
      • As vendas não chegam, ou reembolsos e disputas não mudam a venda: confira na Stripe, em Webhooks, se o destino tem os oito eventos do passo 3 e se as entregas aparecem com sucesso. Se você trocou o segredo de assinatura na Stripe, cole o novo no ClickMax.

      Relacionados