Saltar para o conteúdo principal
A integração Stripe do AgencyHandy permite-lhe aceitar pagamentos por cartão diretamente dos seus clientes através de faturas enviadas dentro da plataforma. Uma vez ligado, os seus clientes veem um checkout familiar alojado pela Stripe, e o estado do pagamento sincroniza de volta ao AgencyHandy automaticamente — sem necessidade de reconciliação manual.
Apenas as funções SuperAdmin e Admin podem ligar ou gerir a integração Stripe. Deve também ter uma conta Stripe verificada com as permissões adequadas antes de começar.

​
Ligar o Stripe

1

Abrir as definições de Integração Stripe

Na barra lateral esquerda, navegue até Integrações → Integração Stripe.
2

Autorizar no Stripe

Clique em Ligar Stripe. É redirecionado para o ecrã de autorização da Stripe. Inicie sessão na sua conta Stripe e clique em Permitir para conceder acesso ao AgencyHandy. Após aprovação, a Stripe redireciona-o de volta ao AgencyHandy automaticamente.
3

Configurar preferências de pagamento

Após o redirecionamento, configure as seguintes opções:
  • Moeda — escolha a moeda de faturação predefinida para o seu workspace.
  • Métodos de pagamento — ative ou desative tipos de cartão (Visa, Mastercard, etc.) conforme suportado pela sua conta Stripe.
  • Preferências de faturação — opcionalmente, defina uma taxa de imposto, prefixo de fatura ou condições de pagamento e datas de vencimento predefinidas.
4

Guardar e confirmar

Clique em Guardar. Aparece um banner de confirmação quando a integração está ativa. A Stripe está agora ligada ao seu workspace e os seus clientes podem pagar faturas online.

​
Testar a integração

Antes de enviar faturas reais, execute um teste rápido de ponta a ponta para confirmar que a ligação está a funcionar corretamente.
1

Criar uma fatura de teste

Crie uma fatura de rascunho dentro do AgencyHandy e atribua-lhe um valor pequeno.
2

Enviar para si mesmo

Envie a fatura para o seu próprio endereço de e-mail ou para um membro da equipa que possa ajudar com o teste.
3

Efetuar um pagamento de teste

Abra o link da fatura e conclua o pagamento usando um cartão de teste Stripe (por ex., 4242 4242 4242 4242) se a sua conta Stripe estiver em modo de teste, ou um cartão real em modo de produção.
4

Verificar a atualização do estado

Regresse ao AgencyHandy e confirme que o estado da fatura mudou para Paga. Se assim for, a sua integração está a funcionar corretamente.

​
Gerir a sua ligação Stripe

Regresse a Integrações → Integração Stripe em qualquer momento para:
  • Atualizar definições de pagamento — altere a moeda, métodos de pagamento ou preferências de faturação.
  • Verificar o estado da ligação — confirme se a Stripe está atualmente ativa.
  • Desligar — clique em Desligar para desvincular a sua conta Stripe. A cobrança de pagamentos pausa imediatamente até voltar a ligar.
  • Reconectar — clique novamente em Ligar Stripe e autorize novamente para restaurar a integração.
Desligar a Stripe pausa a cobrança de pagamentos para todas as faturas pendentes. Os clientes não poderão pagar online até voltar a ligar e autorizar novamente.

​
Notas adicionais

O AgencyHandy nunca armazena as suas credenciais de pagamento. Todos os dados de pagamento são geridos exclusivamente pela infraestrutura segura da Stripe.
  • Uma conta por workspace — só pode ligar uma única conta Stripe a cada workspace do AgencyHandy. Para mudar de conta, desconecte a atual primeiro e depois ligue a nova.
  • Estado de fatura em tempo real — todas as faturas ligadas à Stripe continuam a refletir atualizações de estado em tempo real recebidas diretamente da Stripe.
  • Moeda — certifique-se de que a moeda configurada no AgencyHandy corresponde à moeda ativada na sua conta Stripe para evitar erros de pagamento.