Ligar o seu fornecedor de pagamentos

Já tem uma conta num fornecedor de pagamentos. Agora diz à Passavo que pode usar essa conta. Leva dois minutos.

Se ainda não tiver conta, comece por Criar uma conta Mollie, passo a passo, Criar uma conta Stripe, passo a passo ou Pedir o Payconiq (agora Bancontact Pro).

O que precisa de ter antes

• A função Proprietário. Só um proprietário tem acesso a este ecrã. Nem sequer um administrador: quem pode mudar de fornecedor decide para onde vai o dinheiro. Veja Colaboradores e funções.
• Na Mollie: acesso ao painel da Mollie, porque é lá que copia a chave de API.
• Na Stripe: os seus dados de acesso à Stripe. Durante a ligação, inicia sessão na Stripe, por isso tenha à mão a palavra-passe e a verificação em dois passos.
• No Bancontact Pro: a sua chave de API e a informação sobre se é para o ambiente de teste ou para produção.
• Cinco minutos num computador. Não faça isto à pressa num telemóvel entre duas reuniões.

O ecrã

No menu à esquerda, abra Definições → Pagamentos.

Vê agora três blocos, uns por baixo dos outros: Mollie, Stripe e Bancontact Pro. Por baixo de cada nome aparece o estado: Ainda não ligado, ou Ligado seguido de

• na Mollie, o nome do seu perfil na Mollie;
• na Stripe, o número da sua conta Stripe (começa por acct_);
• no Bancontact Pro, o ambiente da sua chave: EXT ou PROD.

Por baixo do nome podem aparecer dois distintivos: um verde, Ativo para a bilheteira online, no fornecedor que a sua bilheteira online usa, e um cor de laranja, Modo de teste, quando uma ligação ainda não cobra dinheiro real. Veja Modo de teste abaixo.

Na Stripe, em vez de um botão, aparece a frase a vermelho Este fornecedor ainda não foi configurado na plataforma, por isso ainda não é possível ligá-lo.? Então a Stripe ainda não está ativada nesta instalação. Não é uma definição sua: envie uma mensagem ao suporte. A Mollie e o Bancontact Pro podem ser ligados sempre.

Ligar a Mollie

Na Mollie, cola a sua própria chave de API. Não precisa de iniciar sessão em lado nenhum nem de aprovar nada: chave colada, está feito.

Passo 1 — Copie a chave na Mollie

1. Inicie sessão no painel da Mollie, em mollie.com.
2. Abra Developers → API keys.
3. Vê aí duas chaves:
   • a Live API key, que começa por live_. Com ela, os seus visitantes pagam a sério;
   • a Test API key, que começa por test_. Com ela, tudo funciona do princípio ao fim, mas não circula dinheiro real.
4. Copie a chave que quer usar com o pequeno botão de copiar ao lado.

Qual escolher? Se quer começar a vender já e a sua conta Mollie está aprovada, use a Live API key. Se quer primeiro experimentar tudo, ou se ainda está à espera da aprovação da Mollie, use a Test API key. Pode sempre trocar mais tarde.

Atenção: copie a chave propriamente dita, não o ID do perfil (pfl_…) nem um token de organização (access_…). Uma chave de API começa sempre por live_ ou test_.

Passo 2 — Cole-a na Passavo

1. Na Passavo, abra Definições → Pagamentos, no bloco Mollie.
2. Cole a chave no campo Chave de API da Mollie (live_… ou test_…). Não vê os caracteres enquanto cola; é normal.
3. Clique em Guardar chave.

Passo 3 — A Passavo verifica a chave de imediato

A Passavo pergunta à Mollie se a chave funciona, antes mesmo de a guardar. Se estiver tudo certo, vê a mensagem A sua chave Mollie foi guardada. e o bloco indica Ligado, seguido do nome do seu perfil na Mollie. Por baixo aparece Métodos de pagamento ativos na Mollie, com os métodos ativos no seu painel da Mollie — por exemplo Bancontact, iDEAL e cartão. Assim vê logo que colou a chave certa.

Se ainda não houver outro fornecedor ativo, a Mollie passa a ser o fornecedor ativo da sua bilheteira online. Se a Stripe ou o Bancontact Pro já estiverem ativos, esse continua ativo; se mesmo assim quiser usar a Mollie, clique, na Mollie, em Usar este fornecedor.

Se a chave não estiver certa, nada é guardado e vê a mensagem A sua chave Mollie não foi guardada., com o motivo por baixo. Veja E se … abaixo.

Avance de imediato para Testar com um pagamento de 1 cêntimo.

Substituir a chave

Cole uma chave nova no mesmo campo e clique em Substituir chave. Também essa é verificada primeiro; se for recusada, a chave anterior continua a funcionar normalmente. É assim que passa, por exemplo, da Test API key para a Live API key.

O que pode a Passavo fazer com essa chave?

Com a sua chave, a Passavo inicia pagamentos para a sua bilheteira online, para os carregamentos online e para o terminal de pagamento na caixa, consulta o estado desses pagamentos e faz reembolsos. O dinheiro vai diretamente do visitante para a sua conta Mollie; nunca passa por uma conta nossa.

A chave é guardada encriptada e desaparece do ecrã depois de guardada: ninguém a consegue ler ali, nem a sua organização. Se achar que outra pessoa conhece a sua chave, crie uma nova no painel da Mollie e cole-a aqui com Substituir chave.

E o botão "Ligue a sua conta Mollie"?

Em algumas instalações, ao lado de Guardar chave aparece também o botão Ligue a sua conta Mollie. Com ele, liga através do ecrã de início de sessão da Mollie em vez de uma chave. Ambos funcionam; a chave é a via habitual. Se o botão não aparecer, também não precisa dele.

Ligar a Stripe

Na Stripe não cola nenhuma chave. Dá autorização através do próprio ecrã de início de sessão deles.

Passo 1 — Clique no botão

No bloco da Stripe, clique em Ligue a sua conta Stripe.

Passo 2 — Inicie sessão na Stripe

Sai da Passavo e chega a um ecrã da própria Stripe. Olhe para a barra de endereço do navegador: deve aparecer stripe.com. Assim sabe que está a escrever a palavra-passe no sítio certo.

Inicie sessão como de costume, com a verificação em dois passos.

Passo 3 — Dê autorização

Vê agora um ecrã que enumera o que está a autorizar. Uma ligação padrão através do Stripe Connect dá acesso à sua conta Stripe. A Passavo usa-a apenas para iniciar pagamentos, consultar o seu estado e fazer reembolsos. Pode revogá-la a qualquer momento com Desligar.

Se tiver várias contas na Stripe, escolha a certa. Depois clique no botão que dá a autorização (Connect my Stripe account, ou algo semelhante).

Passo 4 — De volta à Passavo

Volta automaticamente a Definições → Pagamentos, com a mensagem A ligação foi concluída com sucesso. no topo. O bloco da Stripe indica agora Ligado.

Uma nova ligação à Stripe passa de imediato a ser o fornecedor ativo da sua bilheteira online: recebe o distintivo verde Ativo para a bilheteira online, mesmo que já houvesse outro fornecedor ativo.

Modo de teste

Se o distintivo cor de laranja Modo de teste aparecer no bloco de um fornecedor, essa ligação não cobra dinheiro real.

Mollie em modo de teste

Se guardou a Test API key (test_…), a sua ligação à Mollie está em modo de teste. Vê isso pelo distintivo Modo de teste e pela mensagem Esta ligação está em modo de teste no bloco da Mollie, e, no topo do seu painel de controlo, pela mensagem a vermelho A sua loja está em modo de teste. Durante o pagamento, a Mollie mostra uma página de teste onde escolhe se o pagamento é bem-sucedido.

Em modo de teste não há pagamento real, nem sequer por parte dos seus visitantes. Uma encomenda paga desta forma é uma encomenda de teste:

• tem uma marca TESTE: na lista de encomendas, no e-mail de confirmação, no PDF e no passe da carteira do telemóvel;
• não conta no painel de controlo e não é enviada como webhook para as suas integrações;
• os bilhetes não dão acesso: a app de leitura recusa-os;
• não é emitida fatura, e um código de desconto ou vale-oferta usado não é descontado.

O visitante também o vê: a página de pagamento da sua loja indica que não há pagamento real.

Passar ao modo real faz-se colando a Live API key e clicando em Substituir chave. É a chave que determina o modo: enquanto a Test API key estiver guardada, tudo continua a ser um teste, mesmo depois de a Mollie ter aprovado a sua conta.

Se colar uma Live API key quando a Mollie ainda não aprovou o seu perfil, a chave é guardada, mas vê a mensagem A Mollie ainda não aprovou o seu perfil. Até lá, a Mollie recusa pagamentos reais. Entretanto, use a Test API key.

Ligou a Mollie anteriormente através do ecrã de início de sessão da Mollie? Então essa ligação entra automaticamente em produção assim que a Mollie aprovar o seu perfil, e no bloco da Mollie aparece um botão Passar ao modo real para não ter de esperar por isso.

Stripe e Bancontact Pro

• A Stripe recebe o distintivo Modo de teste quando a ligação foi feita com o ambiente de teste da Stripe. Não pode alterar isso por si: envie uma mensagem ao suporte. Uma conta Stripe que ainda não foi ativada não recebe esse distintivo; simplesmente ainda não pode aceitar pagamentos.
• O Bancontact Pro recebe o distintivo Modo de teste enquanto tiver guardada uma chave do Ambiente de teste (ext). Para dinheiro real, guarde uma chave de Produção (prod).

Ligar o Bancontact Pro

Também no Bancontact Pro cola uma chave.

1. Cole a sua chave de API no campo Chave da API Bancontact Pro. Não vê os caracteres enquanto cola; é normal.
2. No menu ao lado, escolha o ambiente: Ambiente de teste (ext) ou Produção (prod).
3. Clique em Guardar chave.

Se ainda não houver outro fornecedor ativo, o Bancontact Pro passa a ser o fornecedor ativo da sua bilheteira online. Se a Mollie ou a Stripe já estiverem ativas, essa continua ativa; se mesmo assim quiser usar o Bancontact Pro, clique, no Bancontact Pro, em Usar este fornecedor. Ao contrário do que acontece com a Mollie, a Passavo não verifica uma chave do Bancontact Pro ao guardá-la: só no primeiro pagamento se vê se funciona. Faça, por isso, logo um pagamento de teste.

Atenção: uma chave pertence a um único ambiente. Uma chave de teste em produção dá mensagens de erro que não parecem apontar para nada. Verifique isto, portanto, uma vez a mais do que a menos.

A chave é guardada encriptada e desaparece do ecrã. Se mais tarde a quiser substituir, basta colar uma nova e clicar em Substituir chave. Isso não altera qual o fornecedor ativo.

Que fornecedor usa a sua bilheteira online?

Pode ligar vários, mas a bilheteira online usa um de cada vez. O visitante vê, portanto, apenas os métodos de pagamento desse fornecedor.

Reconhece o fornecedor ativo pelo distintivo verde Ativo para a bilheteira online. Se quiser outro, clique, nesse outro, em Usar este fornecedor. O distintivo muda com ele.

As encomendas existentes ficam no fornecedor com que foram pagas. Um reembolso passa sempre por esse fornecedor, mesmo que a sua bilheteira online entretanto use outro — desde que esse fornecedor antigo continue ligado.

O URL de webhook

Assim que estiver ligado, aparece no bloco um URL de webhook, algo no formato https://{domein}/webhooks/mollie.

Um webhook é um endereço para onde o fornecedor nos envia uma mensagem assim que acontece algo com um pagamento. É assim que sabemos, em menos de um segundo, que foi pago, sem que alguém tenha de clicar em atualizar.

Não precisa de fazer nada com ele; isso também está escrito por baixo do endereço: Não precisa de introduzir este URL em lado nenhum: tratamos disso.

Fornecedor	Como o endereço chega ao fornecedor
Mollie	É enviado automaticamente com cada pagamento
Stripe	Está configurado ao nível da plataforma
Bancontact Pro	É enviado automaticamente com cada pagamento

Um pagamento continua Pendente do seu lado enquanto o fornecedor diz que foi bem-sucedido? Então essa mensagem não chegou. Cada webhook recebido fica registado, por isso é possível verificar — escreva-nos e analisamos consigo. Veja também Quando um pagamento falha.

Desligar

Com Desligar corta a ligação. Primeiro, é-lhe pedida uma confirmação.

O que acontece:

• a sua bilheteira online deixa de poder iniciar novos pagamentos através desse fornecedor;
• na Mollie e no Bancontact Pro, a sua chave é apagada do nosso lado. Se também a quiser tornar inutilizável na Mollie, crie uma nova chave no painel da Mollie;
• na Stripe, a autorização é também revogada na própria Stripe, para que a nossa aplicação desapareça do seu painel;
• as suas encomendas existentes mantêm-se normalmente, com a referência ao fornecedor com que foram pagas.

Se desligar o fornecedor ativo enquanto ainda houver outro ligado, a sua bilheteira online passa a usar esse outro, mesmo que o distintivo verde não apareça em lado nenhum. Clique, por isso, de imediato em Usar este fornecedor no fornecedor que quer usar.

Atenção: não desligue um fornecedor com o qual ainda tenha vendido bilhetes para um evento que ainda não se realizou. Um reembolso dessas encomendas passa por esse fornecedor. Depois de o desligar, já não o pode iniciar a partir da Passavo; recebe a mensagem Esta organização não tem nenhum fornecedor de pagamentos ligado. e terá de reembolsar no painel do próprio fornecedor. Na Mollie, resolve isso voltando a colar a mesma chave.

Erros frequentes

Deixar ficar a Test API key. Com uma chave test_, cada pagamento é um teste, incluindo o dos seus visitantes, e os bilhetes deles não dão acesso. Antes de partilhar o seu link, verifique se o distintivo Modo de teste desapareceu.

Colar outra coisa que não a chave. O ID do perfil (pfl_…), a sua palavra-passe ou um token de organização (access_…) não funcionam. Uma chave começa por live_ ou test_.

Copiar só um pedaço da chave. Use o botão de copiar no painel da Mollie em vez de selecionar a chave com o rato.

Ligar um segundo fornecedor "para experimentar". Uma nova ligação à Stripe passa de imediato a ser o fornecedor ativo. Depois, verifique sempre se o distintivo verde Ativo para a bilheteira online está no fornecedor certo.

Pensar que ligar basta. Os métodos de pagamento que o visitante vê são ativados no painel do fornecedor, não aqui.

Tentar como administrador. Nesse caso nem sequer vê este menu. Peça ao proprietário.

E se …

E se a Passavo recusar a minha chave Mollie?

Por baixo da mensagem A sua chave Mollie não foi guardada. aparece o motivo:

• Isto não parece uma chave de API da Mollie. Colou algo que não começa por live_ ou test_, ou só um pedaço. Copie de novo a chave.
• Isto é um token de organização da Mollie, não uma chave de API. Colou um token que começa por access_. Use a Live API key ou a Test API key de Developers → API keys.
• A Mollie não reconhece esta chave. A chave é inválida ou foi entretanto renovada na Mollie. Copie a chave que está agora no seu painel da Mollie.
• A Mollie não está acessível neste momento. Nesse caso, o problema não é seu. Tente de novo dentro de alguns minutos.

Em todos estes casos, nada é guardado, e uma chave que já funcionava continua a funcionar.

E se em "Métodos de pagamento ativos na Mollie" não aparecer nada?

Então, no seu painel da Mollie, ainda não há nenhum método de pagamento ativo, e ninguém consegue pagar. Ative pelo menos um — o Bancontact, por exemplo — e depois volte a colar a chave, para que a lista seja atualizada.

E se na Stripe aparecer uma mensagem de erro?

Se voltar com A ligação foi interrompida., recusou no ecrã de autorização ou fechou a janela. Se aparecer O fornecedor devolveu um erro durante a ligação., tente outra vez e verifique na Stripe se a sua conta está em ordem.

Se aparecer uma página de erro em vez do ecrã Pagamentos, a sua tentativa expirou: a ligação tem de ficar concluída em quinze minutos. Comece simplesmente de novo a partir de Definições → Pagamentos.

E se quiser mudar de fornecedor a meio de uma venda antecipada?

É possível. Ligue o novo e, se necessário, clique nele em Usar este fornecedor. Mantenha o antigo ligado enquanto ainda tiver bilhetes vendidos através dele: um reembolso dessas encomendas antigas passa automaticamente pelo fornecedor antigo.

E se tiver perdido a minha chave do Bancontact Pro?

Peça uma nova ao seu banco. Nós não a podemos mostrar: é guardada encriptada e desaparece do ecrã depois de guardada. Na Mollie é igual, mas aí basta copiá-la de novo do painel da Mollie.

Perguntas frequentes

Veem a minha palavra-passe do fornecedor? Não. Na Mollie cola uma chave, não uma palavra-passe. Na Stripe escreve a palavra-passe no site deles; nós só recebemos de volta uma autorização, que revoga com Desligar.

Porquê uma chave na Mollie, e não um botão como na Stripe? Porque assim é mais rápido e não tem de aprovar nada: copiar a chave, colar, feito. O seu dinheiro chega na mesma diretamente à sua própria conta Mollie.

Posso fazer a ligação num telemóvel? Tecnicamente sim, mas não o faça: copiar uma chave comprida ou ler com calma um ecrã de autorização funciona melhor num computador.

Posso testar antes de vender a sério? Sim, e deve fazê-lo. Veja Testar com um pagamento de 1 cêntimo.

Porque vejo tanto Bancontact Pay como Bancontact Pro? Porque são duas coisas diferentes. O Bancontact Pro é o que a sua organização pede e liga aqui; é daí que vem a sua chave. O Bancontact Pay é a app com que o visitante lê o QR. Até março de 2026, ambos se chamavam Payconiq. Veja Pedir o Payconiq (agora Bancontact Pro).

O que acontece aos meus bilhetes se desligar? Nada. Bilhetes, encomendas e leituras mantêm-se. Só deixam de ser possíveis novos pagamentos através desse fornecedor.