Como usar webhook do Stripe com GeHost Print

Como usar o Webhook do Stripe com a GeHost: um guia simples, passo a passo

Olá, amigo(a) GeHost! Seja bem-vindo(a) ao seu novo guia de superpoderes digitais. Hoje vamos aprender como integrar o Webhook do Stripe com seu site hospedado na GeHost — sem complicação, com calma, e com um toque de senso de propósito. 💡

Imagine assim: toda vez que um cliente paga uma assinatura no seu site (via Stripe), você quer que o sistema automagicamente receba essa informação — para ativar o acesso, enviar um e-mail de boas-vindas, ou atualizar um banco de dados.

É exatamente isso que o Webhook faz: ele “liga” seu site ao Stripe e diz: “Ei, quando algo importante acontecer, me avise!”

Seu site está na GeHost? Ótimo! Vamos fazer isso juntos, passo a passo. Sem pressa. Sem medo. Você está no lugar certo.

Passo 1: Crie um script PHP para receber o webhook

Primeiro, vamos criar um arquivo que vai "escutar" as mensagens do Stripe. Ele será o ponto de recebimento das notificações.

1. Acesse o cPanel da sua conta GeHost. Se você ainda não está logado, use este link: cpanel.gehost.com.br
2. Na tela de login, insira seu usuário e senha e clique em Log in.
3. Depois de logado, você verá o painel principal. Clique em Arquivos e depois em Gerenciador de Arquivos.
4. No Gerenciador de Arquivos, vá até a pasta public_html (ou a pasta do seu site, se estiver em subdiretório).
5. Clique em Novo Arquivo e digite o nome: stripe-webhook.php
6. Abra o arquivo e cole o código abaixo (não se preocupe, não precisa entender tudo agora — é só seguir o passo a passo):

<?php
// Recebe o webhook do Stripe
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_STRIPE_SIGNATURE'];
$endpoint_secret = 'sk_test_...'; // Coloque aqui sua chave secreta do Stripe (não compartilhe!)

try {
    $event = \Stripe\Webhook::constructEvent($payload, $signature, $endpoint_secret);
} catch (Exception $e) {
    http_response_code(400);
    echo 'Erro: ' . $e->getMessage();
    exit;
}

// Agora você pode processar o evento
switch ($event->type) {
    case 'checkout.session.completed':
        // Aqui você pode ativar acesso, enviar e-mail, salvar no banco...
        file_put_contents('webhook-log.txt', date('Y-m-d H:i:s') . ' - Pagamento concluído: ' . $event->data->object->id . "\n", FILE_APPEND);
        break;
    default:
        echo 'Evento não tratado: ' . $event->type;
}

http_response_code(200);
echo 'OK';
?>

Dica do Sensei: Não coloque sua chave secreta do Stripe aqui no código final! Use um arquivo de configuração separado ou variáveis de ambiente. Este exemplo é para entender o fluxo.

Passo 2: Configure o webhook no Stripe

Agora que seu script está pronto, vamos dizer ao Stripe: “Me avise quando um pagamento acontecer!”

1. Entre no Painel do Stripe (https://dashboard.stripe.com).
2. Clique em Developers → Webhooks.
3. Clique em Adicionar endpoint.
4. No campo URL, digite: https://seusite.com.br/stripe-webhook.php (substitua pelo seu domínio real).
5. Selecione os eventos que deseja receber, como: checkout.session.completed (quando o pagamento for feito).
6. Clique em Adicionar endpoint.

Pronto! O Stripe agora sabe onde mandar as notificações.

Passo 3: Teste com o Stripe CLI (opcional, mas super útil)

Antes de colocar no ar, teste se tudo está funcionando. Use o Stripe CLI para simular um pagamento:

1. Instale o Stripe CLI (se ainda não tiver): docs.stripe.com/stripe-cli
2. Execute: stripe listen --forward-to https://seusite.com.br/stripe-webhook.php
3. Isso vai criar um webhook temporário e mostrar as mensagens no terminal.
4. Use o comando stripe trigger checkout.session.completed para simular um pagamento.
5. Veja se o arquivo webhook-log.txt foi criado e se tem a mensagem.

Dica do Sensei: Se o log aparecer, parabéns! Seu webhook está funcionando. Se não, verifique o caminho do arquivo e o acesso ao servidor.

Passo 4: Ative o script no seu site

Seu script está pronto. Agora, use o que ele recebe para fazer algo útil:

• Ativar acesso a um curso ou conteúdo premium.
• Enviar um e-mail automático de boas-vindas.
• Atualizar um banco de dados com o novo cliente.
• Registrar o pagamento em um sistema interno.

Se precisar de ajuda para automatizar algo específico, é só chamar a nossa equipe de suporte — estamos aqui pra te ajudar!

Conclusão: Você está no controle

Parabéns! Hoje você aprendeu como usar o Webhook do Stripe com a GeHost — um passo poderoso para tornar seu site mais inteligente, automático e profissional.

Com esse sistema, você não precisa ficar olhando e-mails ou verificando pagamentos à mão. O sistema faz isso por você — com precisão, rapidez e sem erros.

Se você gostou desse guia, compartilhe com um amigo que também quer automatizar seu negócio. E lembre-se: todo grande sistema começa com um pequeno script.

Até a próxima, com amor e código 💻✨

— Sensei da GeHost, sempre ao seu lado