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.
- Acesse o Site do Stripe: Visite o site do Stripe.
- Crie uma Conta: Se ainda não tiver uma conta no Stripe, crie uma.
- Confirme Sua Conta: Verifique seu e-mail para confirmar sua conta e faça login no painel do Stripe.
- 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.
- 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".
- 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:
- Faça login na área administrativa: Acesse o painel administrativo do seu site eDirectory utilizando suas credenciais de acesso.
- 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".
- 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.
- 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.
- Acesse seu Painel da Stripe: Faça login na sua conta Stripe através do site oficial.
- Abra a Aba de Webhooks: No menu "Desenvolvedores", clique na aba "Webhooks".
- Adicione um Novo Destino: Clique no botão "Adicionar destino".
- 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://.
- Selecione os Eventos para Escutar: Clique no botão "Selecionar eventos".
- 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".
- 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.