Como Ativar o Stripe no meu eDirectory

Introdução

Integrar um gateway de pagamento ao seu site eDirectory é essencial para receber pagamentos dos seus usuários quando eles assinarem sua plataforma. O Stripe é uma solução de pagamento poderosa que permite oferecer pagamentos únicos, assinaturas e incentivos de teste. Este artigo irá guiá-lo pelas etapas para integrar o Stripe ao seu site eDirectory.


Benefícios de usar o Stripe

  • Assinaturas: Ofereça opções de pagamento flexíveis para seus anunciantes.
  • Pagamentos Recorrentes: Automatize ciclos de cobrança para economizar tempo e garantir uma receita consistente.
  • Incentivos de Teste: Ofereça promoções, como um teste gratuito no primeiro mês, para atrair mais usuários.

Etapas para Integrar o Stripe:

Etapa 1: Obter a API do Stripe

Antes de habilitar o Stripe no seu site eDirectory, você precisa obter a chave da API no painel do Stripe.

  1. Acesse o Site do StripeVisite o site do Stripe.
  2. Crie uma Conta: Se ainda não tiver uma conta no Stripe, crie uma.
  3. Confirme Sua Conta: Verifique seu e-mail para confirmar sua conta e faça login no painel do Stripe.
  4. Ative Sua Conta: Adicione informações de cartão de crédito para ativar sua conta.

Nota: O modo de teste deve estar desativado para usar as chaves em ambiente de produção. Certifique-se de desativar o modo de teste no painel do Stripe. Para isso, o Stripe exige detalhes válidos de cartão de crédito.

  1. Obtenha a Chave Secreta: Após a ativação da sua conta e a desativação do modo de teste, vá até a seção "Desenvolvedores". Para isso, use a barra de pesquisa localizada no topo do seu painel da Stripe e digite "Desenvolvedores". Nos resultados exibidos, clique no menu "Desenvolvedores".

  1. Revele e Copie Sua Chave Secreta da API: localize a seção "Chave secreta". Em seguida, clique no botão "Revelar chave ativa" para exibir sua chave secreta ativa. Copie essa chave com cuidado e armazene-a em um local seguro.

Observação Importante: Por motivos de segurança, sua chave secreta ativa será exibida apenas uma vez. Certifique-se de copiá-la corretamente antes de clicar no botão "Concluído".


Etapa 2: Habilitar o Stripe no eDirectory

Com sua Chave Secreta da Stripe em mãos, siga estas etapas para ativar a Stripe como plataforma de pagamento na sua área administrativa do eDirectory:

  1. Faça login na área administrativa: Acesse o painel administrativo do seu site eDirectory utilizando suas credenciais de acesso.
  2. Vá até as Configurações adicionais e Gateways de Pagamento: Clique na aba "Configurações", depois selecione "Produtos e Planos" e, por fim, clique na aba "Configurações adicionais e gateways de pagamento".

  1. Ativar Stripe: Localize o botão de ativação do Stripe e habilite-o. No campo "Chave da API", cole a Chave Secreta da Stripe que você copiou na Etapa 1.

  •  Se você pretende oferecer pagamentos recorrentes de assinatura, certifique-se de que a opção "Cobrança Automática" também esteja ativada.

  1. Configure Planos de Teste (Opcional):
  • Para oferecer testes gratuitos em planos de assinatura específicos, vá até "Produtos e Planos" e depois selecione a aba "Planos".
  • Para cada plano em que deseja oferecer um teste, ative a opção de teste definindo a duração do período de teste em dias.

Etapa 3: Configure a URL do Webhook

Para garantir a renovação automática e contínua dos pagamentos de assinatura, é necessário configurar uma URL de webhook dentro da sua conta Stripe. Os webhooks permitem que a Stripe comunique eventos importantes — como pagamentos bem-sucedidos — diretamente para o seu site eDirectory em tempo real.

  1. Acesse seu Painel da Stripe: Faça login na sua conta Stripe através do site oficial.
  2. Abra a Aba de Webhooks: No menu "Desenvolvedores", clique na aba "Webhooks".
  3. Adicione um Novo Destino: Clique no botão "Adicionar destino".

  1. Digite a URL do Webhook: No campo "URL do endpoint", insira o protocolo seguido de /sponsors/billing/stripe_webhook.php com o domínio real do seu site, conforme o exemplo abaixo:

https://seudominio.com/sponsors/billing/stripe_webhook.php

Nota importante: Se o seu site utiliza HTTPS, certifique-se de que a URL comece com https://.

  1. Selecione os Eventos para Escutar: Clique no botão "Selecionar eventos".
  2. Escolha o Evento "invoice.payment_succeeded": Na janela de seleção de eventos, pesquise por "invoice.payment_succeeded", marque a caixa ao lado dele e, em seguida, clique em "Adicionar eventos".

  1. Salvar o Endpoint do Webhook: Por fim, clique no botão "Adicionar endpoint" para salvar a configuração do seu webhook.

Observação: Se o seu site eDirectory utiliza domínios adicionais ou múltiplos domínios, será necessário criar um endpoint de webhook separado na Stripe para cada domínio, utilizando o domínio correspondente na URL do Webhook.


Conclusão

Integrar o Stripe ao seu site eDirectory permite oferecer uma experiência de pagamento perfeita para seus usuários, mantendo processos de cobrança flexíveis e automatizados. Caso tenha dúvidas ou precise de assistência, entre em contato com nossa equipe de suporte pelo e-mail support@edirectory.com.

Isso respondeu à sua pergunta? Obrigado pelo feedback Ocorreu um problema ao enviar seu feedback. Tente novamente mais tarde.