Pular para o conteúdo principal
A integração do AgencyHandy com o Stripe permite que você aceite pagamentos com cartão diretamente dos seus clientes por meio de faturas enviadas dentro da plataforma. Uma vez conectado, seus clientes veem um checkout familiar hospedado pelo Stripe, e o status do pagamento é sincronizado de volta ao AgencyHandy automaticamente — sem necessidade de conciliação manual.
Apenas as funções SuperAdmin e Admin podem conectar ou gerenciar a integração com o Stripe. Você também deve ter uma conta Stripe verificada com as permissões apropriadas antes de começar.

​
Conectar o Stripe

1

Abra as configurações de Integração do Stripe

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

Autorize no Stripe

Clique em Conectar Stripe. Você é redirecionado para a tela de autorização do Stripe. Faça login na sua conta Stripe e clique em Permitir para conceder acesso ao AgencyHandy. Uma vez aprovado, o Stripe redireciona você de volta ao AgencyHandy automaticamente.
3

Configure as preferências de pagamento

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

Salve e confirme

Clique em Salvar. Um banner de confirmação aparece quando a integração está ativa. O Stripe agora está vinculado ao seu workspace e seus clientes podem pagar faturas online.

​
Teste a integração

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

Crie uma fatura de teste

Crie uma fatura de rascunho dentro do AgencyHandy e atribua a ela um valor pequeno.
2

Envie para você mesmo

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

Conclua um pagamento de teste

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

Verifique a atualização de status

Retorne ao AgencyHandy e confirme que o status da fatura mudou para Pago. Se sim, sua integração está funcionando corretamente.

​
Gerencie sua conexão com o Stripe

Retorne a Integrações → Integração Stripe a qualquer momento para:
  • Atualizar configurações de pagamento — altere moeda, métodos de pagamento ou preferências de faturamento.
  • Verificar o status da conexão — confira se o Stripe está atualmente ativo.
  • Desconectar — clique em Desconectar para desvincular sua conta Stripe. A cobrança de pagamentos é pausada imediatamente até que você reconecte.
  • Reconectar — clique em Conectar Stripe novamente e reautorize para restaurar a integração.
Desconectar o Stripe pausa a cobrança de pagamentos de todas as faturas em aberto. Os clientes não poderão pagar online até que você reconecte e reautorize.

​
Notas adicionais

O AgencyHandy nunca armazena suas credenciais de pagamento. Todos os dados de pagamento são tratados exclusivamente pela infraestrutura segura do Stripe.
  • Uma conta por workspace — você pode conectar apenas uma única conta Stripe a cada workspace do AgencyHandy. Para mudar de conta, desconecte a atual primeiro e depois reconecte com a nova conta.
  • Status de fatura em tempo real — todas as faturas vinculadas ao Stripe continuam a refletir atualizações de status em tempo real recebidas diretamente do Stripe.
  • Moeda — certifique-se de que a moeda configurada no AgencyHandy corresponde à moeda habilitada na sua conta Stripe para evitar erros de pagamento.