Configuração da Integração com Geras

⚠️ Instruções para o Administrador

Esta página contém instruções técnicas para integrar o sistema de pagamento Geras com a plataforma UPMED.

Sistema de Pagamento: Geras

A UPMED utiliza o sistema Geras para processar pagamentos recorrentes. A comunicação entre os sistemas acontece via webhooks automáticos.

Passo 1: Configure o Link de Pagamento no Geras

1. Acesse o painel do Geras e crie um produto/assinatura mensal
2. Configure o valor (ex: R$ 49/mês)
3. Copie o link de checkout gerado pelo Geras
4. No arquivo pages/Subscription.js, localize a linha 28 e substitua pelo seu link do Geras:

const atenexPaymentLink = "https://checkout.geras.com.br/seu-link-aqui";

Passo 2: Configure o Webhook no Geras

No painel do Geras, acesse as configurações de Webhooks e configure para enviar notificações para:

URL do Webhook:

https://api.base44.com/webhooks/geras/upmed

Este endpoint será configurado pela equipe Base44 para processar automaticamente os eventos de pagamento

Passo 3: Eventos do Geras que serão processados

O webhook será configurado para processar os seguintes eventos do Geras:

  • ✓
    Assinatura Criada:

    Quando um novo usuário se cadastra no Geras

  • ✓
    Pagamento Confirmado:

    Quando o pagamento é aprovado, libera o acesso na UPMED

  • ✓
    Renovação Bem-sucedida:

    Atualiza a data de vencimento quando a mensalidade é paga

  • ✗
    Pagamento Falhou:

    Quando a cobrança não é aprovada, bloqueia o acesso

  • ✗
    Assinatura Cancelada:

    Quando o usuário cancela, mantém acesso até o fim do período pago

Passo 4: Campos que serão atualizados automaticamente

O webhook atualizará automaticamente os seguintes campos no perfil do usuário:

subscription_status:"active" | "inactive" | "cancelled"
subscription_end_date:Data da próxima cobrança
atenex_customer_id:ID do cliente no Geras
atenex_subscription_id:ID da assinatura no Geras

* Os campos mantêm os nomes "atenex_*" por compatibilidade técnica, mas armazenam dados do Geras

Passo 5: Como identificar o usuário

É importante que o email do usuário no Geras seja o mesmo usado no login da UPMED:

📧 Correspondência de Email

O webhook usa o email enviado pelo Geras para identificar qual usuário deve ter o acesso atualizado na UPMED. Certifique-se de que os emails sejam idênticos nos dois sistemas.

Passo 6: Período Trial (Opcional)

Para dar um período de teste gratuito aos novos usuários (ex: 7 dias grátis):

Opção 1: Configurar no Geras

Configure o período trial diretamente no checkout do Geras

Opção 2: Configurar manualmente

Você pode definir manualmente no dashboard (Dashboard → Data → User) os campos:

  • • subscription_status: "trial"
  • • trial_end_date: Data de hoje + 7 dias

💡 Precisa de Ajuda?

Entre em contato com o suporte da Base44 através do botão de feedback na barra lateral para que possamos configurar o webhook do Geras para você.

Tenha em mãos:

  • Credenciais da API do Geras (ou acesso ao painel)
  • Link do produto/assinatura no checkout do Geras
  • Período de trial desejado (se houver)
  • Email do seu usuário admin na UPMED

🔄 Fluxo Automático

Uma vez configurado, todo o processo será automático:

  1. Usuário assina no Geras
  2. Geras envia notificação para o webhook
  3. Webhook atualiza automaticamente o acesso do usuário na UPMED
  4. Usuário pode acessar todo o conteúdo premium imediatamente