Manual / Pagamentos

Configurar o Stripe

Atualizado em 2026-10-01

Definições → Integrações → Pagamentos → Stripe

Com o Stripe aceita cartão de crédito, Apple Pay e Google Pay no seu widget de reservas e em cada link de pagamento que o BedFlow envia. Não precisa de conhecimentos técnicos, apenas de cerca de meia hora e dos dados da sua empresa à mão.

Um prestador de cartões de cada vez. Por alojamento escolhe o Stripe ou o Mollie, nunca os dois. O Bancontact / WERO pode ficar ativo ao lado de qualquer um deles. Tem dúvidas? Leia Configurar o Mollie.

O que o Stripe lhe pergunta no registo (e o que deve preencher)

Durante o registo, o Stripe faz uma série de perguntas para conhecer a sua empresa. Isto é obrigatório em qualquer instituição de pagamento na Europa. Eis o que pretendem saber:

O Stripe pergunta O que preenche
Tipo de empresa Empresário em nome individual ou sociedade, tal como consta no registo comercial (na Bélgica, o KBO). Também é possível como particular, mas nesse caso aplicam-se limites mais baixos
Número de empresa / número de IVA O seu número de empresa (na Bélgica: BE 0xxx.xxx.xxx)
O que vende? (industry / setor) Travel & lodging → Hotels, inns & resorts (ou Vacation rentals para uma casa de férias)
Descrição do seu produto Uma frase chega: "Arrendamento de alojamento de férias com dormidas, pagamento de sinal e saldo."
Website O URL do seu site BedFlow ou do seu próprio website
Número de conta (IBAN) A conta para onde o Stripe transfere as suas receitas
Statement descriptor O nome que o hóspede vê no extrato do cartão. Indique aqui o nome do seu alojamento, e não o nome da sua sociedade; caso contrário, arrisca contestações desnecessárias
Verificação de identidade (KYC) Foto do seu cartão de cidadão ou passaporte + selfie. É uma obrigação legal, faz-se no browser e demora poucos minutos

Não precisa de um ambiente de testes. Todas as contas Stripe têm um modo de teste, mas esse destina-se a programadores. Introduza simplesmente os seus dados reais e conclua a ativação; a partir daí a sua conta fica em modo live e recebe logo pagamentos reais.

Pelo caminho, o Stripe pode pedir comprovativos adicionais (certidão do registo comercial, declaração bancária). É normal e não impede a criação da conta. Entretanto pode avançar com a ligação descrita abaixo; apenas os pagamentos à sua conta ficam à espera até a verificação estar concluída.

A ligação ao BedFlow

Cola no BedFlow três valores do seu painel Stripe. Depois de a sua conta Stripe estar ativa:

  1. Obter as chaves. Painel Stripe → Developers → API keys. Coloque o interruptor no canto superior direito em live (não em test) e copie:
    • Publishable key: começa por pk_live_
    • Secret key: começa por sk_live_ (clique em "Reveal"; só fica totalmente visível uma vez)
  2. Criar o webhook. Painel Stripe → Developers → Webhooks → Add endpoint:
    • URL: https://bedflow.eu/webhooks/stripe-payment (o BedFlow mostra o mesmo URL no campo URL do webhook (copie-o para o Stripe))
    • Eventos: checkout.session.completed, payment_intent.succeeded e payment_intent.payment_failed
    • Em seguida, copie o Signing secret: começa por whsec_
  3. Preencher no BedFlow. Vá a Definições → Integrações, categoria Pagamentos, e clique em Configurar no mosaico do Stripe. Ative Ativar Stripe e cole os três valores em 1. Publishable key, 2. Secret key e 3. Webhook secret. Clique em Guardar.

O mosaico mantém-se em Configuração incompleta enquanto faltar a Publishable key ou a Secret key. Só quando passar a Ligado é que um hóspede consegue realmente pagar.

O webhook é a peça que avisa o BedFlow de que o pagamento foi feito. Sem webhook secret, o hóspede paga, mas a reserva continua do seu lado em "a aguardar pagamento". O mosaico também o avisa disso.

Verificar se funciona

Faça uma reserva de teste na sua própria página de reservas, com um montante pequeno, e pague-a com um cartão real. Deve então ver:

  • o pagamento no seu painel Stripe, em Payments;
  • o mesmo pagamento no BedFlow, em Diário → Pagamentos, em poucos segundos;
  • a reserva a passar sozinha para paga, e o e-mail de confirmação a ser enviado.

Se a reserva continuar em "a aguardar pagamento" enquanto o Stripe já mostra o dinheiro, o erro está quase sempre no passo 2: URL errado, evento em falta ou o signing secret de um outro endpoint. Em Webhooks, o Stripe mostra para cada tentativa se recebeu um 200 como resposta.

Depois pode simplesmente reembolsar o montante a partir do Stripe.

Quanto custa?

O Stripe cobra por cada pagamento bem-sucedido uma taxa que depende do tipo de cartão e do país do cartão; cartões de fora da Europa e Amex custam mais. Consulte as tarifas atuais no site do Stripe. O próprio BedFlow não cobra nada por cima: liga a sua própria conta Stripe e o dinheiro vai diretamente para a sua conta.

Perguntas frequentes

Posso mudar do Stripe para o Mollie? Sim. No mosaico do Stripe, desative Ativar Stripe e guarde; depois ative o Mollie. Veja Configurar o Mollie.

Posso cobrar o saldo de um hóspede da Booking.com no cartão dele? Pode fazê-lo no check-out, para reservas que chegaram através de um canal, desde que tenha o seu próprio Stripe ligado e o cartão do canal tenha sido guardado no Stripe. Esta última parte é preparada uma única vez pelo suporte. Veja Gestão de pagamentos por canal.

Relacionado

← Voltar à categoria