WonderMoney Docs
Começar

Ligar a primeira conta bancária

Regista a tua própria aplicação gratuita na Enable Banking e depois liga uma conta bancária real à WonderMoney.

A WonderMoney deixou de ter um serviço de ligação bancária próprio e partilhado por todos os utilizadores — manter esse modelo de forma gratuita tornou-se insustentável. Em vez disso, as ligações bancárias passam a usar a Enable Banking num modelo "traz a tua própria chave" (BYOK): registas a tua própria aplicação gratuita na Enable Banking, e os servidores da WonderMoney usam as credenciais dessa aplicação — nunca uma credencial partilhada — para ligar e ler os teus dados bancários. Assim as ligações bancárias mantêm-se gratuitas, tanto para ti como para a WonderMoney.

A configuração abaixo é feita uma única vez. Durante o primeiro arranque podes ser convidado a ligar um banco no passo da conta; se ainda não tiveres configurado a tua chave da Enable Banking, faz isso primeiro seguindo os passos abaixo e depois volta para ligar o banco. Depois de guardada, a chave fica guardada: qualquer banco que ligues mais tarde, mesmo a partir das Definições, usa a mesma chave.

Antes de começar

Vais precisar de uns minutos, do email que queres usar na Enable Banking e de acesso ao início de sessão do teu banco para aprovar a ligação mais à frente neste mesmo fluxo. Não é preciso nenhum conhecimento técnico além de copiar dois valores — um identificador e uma chave — da Enable Banking para a WonderMoney.

Configura a tua aplicação na Enable Banking

  1. Vai a enablebanking.com/sign-in/ e introduz o teu email. A Enable Banking envia um link mágico de utilização única — não há palavra-passe a criar. Clica no link para abrir o Painel de Controlo.
  2. No Painel de Controlo, vai a Applications (enablebanking.com/cp/applications) e clica em Add a new application.
  3. Define Environment como Production — lê o aviso abaixo antes de continuares.
  4. Dá um nome e uma descrição à aplicação. Qualquer valor descritivo serve, por exemplo "WonderMoney" com uma linha a dizer que é para uso pessoal.
  5. Define Redirect URL exatamente como aqui: https://api.wonder.money/v1/banking/enable-banking/callback — lê a nota abaixo.
  6. Preenche Privacy URL e Terms URL — lê o aviso abaixo antes de submeteres o formulário.
  7. Na geração da chave, escolhe Generate in the browser and export private key. A Enable Banking gera um par de chaves por ti e descarrega automaticamente um ficheiro .pem — lê o aviso abaixo sobre como guardá-lo em segurança.
  8. Submete o formulário para registar a aplicação.

Escolhe Production, não Sandbox

O Sandbox só liga a dados bancários fictícios — nunca vai conseguir ligar a tua conta real, por mais que esteja tudo o resto bem configurado. É o passo mais fácil de errar em toda esta página, e o que mais vale a pena confirmar duas vezes antes de submeteres o formulário.

O URL de redirecionamento é da WonderMoney, não teu

https://api.wonder.money/v1/banking/enable-banking/callback é o endereço do próprio backend da WonderMoney. Estás a registar uma aplicação que fala com os servidores da WonderMoney, por isso este valor é fixo — introduz exatamente como está escrito, não o teu próprio domínio.

Privacy URL e Terms URL são obrigatórios em Production, mesmo que o formulário não o diga

O formulário da Enable Banking não marca estes campos como obrigatórios, mas numa aplicação Production o envio falha em silêncio se algum ficar vazio, sem mostrar qualquer mensagem de erro. Usa:

  • Privacy URL: https://docs.wonder.money/about/privacy-policy
  • Terms URL: https://docs.wonder.money/about/terms-of-service

Guarda a chave descarregada imediatamente

A Enable Banking mostra e descarrega esta chave privada uma única vez. Não a consegue voltar a mostrar. Guarda o ficheiro .pem num sítio seguro — por exemplo, um gestor de palavras-passe — antes de fazeres qualquer outra coisa. Se a perderes, a única solução é registar uma aplicação nova de raiz.

Se preferires gerar tu mesmo o par de chaves e entregar à Enable Banking apenas o certificado público, escolhe Generate outside the browser and import public certificate e segue a documentação da API da Enable Banking para esse caminho.

Ativa a tua aplicação ligando a tua própria conta bancária

Depois de submeteres o formulário, a página da aplicação mostra "Restricted Production, not yet activated" com dois botões.

Clica em "Activate by linking accounts" — não em "Request activation"

Activate by linking accounts é a opção certa: guia-te pelo próprio fluxo de consentimento da Enable Banking para ligares uma das tuas contas bancárias reais, o que ativa a aplicação para uso pessoal. Os Termos de Serviço da Enable Banking descrevem este caminho como destinado "solely for evaluation purposes or for the personal use of private individuals", pelo que não é exigida qualquer verificação empresarial.

Request activation é o caminho empresarial, que exige verificação KYB (know-your-business). Ignora-o.

  1. Clica em Activate by linking accounts.
  2. Escolhe o teu banco e inicia sessão, aprovando o acesso da mesma forma que farias em qualquer ligação Open Banking.
  3. Assim que o banco confirmar o consentimento, volta ao Painel de Controlo — o estado da aplicação atualiza-se para refletir que já está ativada.

Adiciona a tua chave à WonderMoney

  1. Na página da aplicação, copia o Application ID — um UUID apresentado perto do topo.
  2. Localiza o ficheiro .pem que descarregaste antes.
  3. Na WonderMoney, abre Definições → Fornecedor bancário.
  4. Cola o Application ID em Application ID, e o conteúdo completo do ficheiro .pem em Private key.
  5. Guarda. A WonderMoney valida a credencial junto da Enable Banking antes de a guardar, por isso um identificador mal copiado ou uma chave incompleta são rejeitados de imediato em vez de falharem mais tarde.

O que a WonderMoney faz com a tua chave

A tua chave privada é encriptada em repouso (AES-256-GCM) e nunca volta a ser mostrada depois de guardada. A WonderMoney usa-a apenas para autenticar os teus próprios pedidos à Enable Banking — não é partilhada com mais ninguém, nem sequer com outros utilizadores da WonderMoney.

Liga o teu primeiro banco

Depois de a tua chave estar guardada e ativa, ligar um banco funciona como qualquer ligação bancária na WonderMoney: escolhe o país, escolhe o banco, inicia sessão e aprova o acesso no teu banco, e aguarda a primeira sincronização. Consulta Ligar conta bancária para essa parte do fluxo em detalhe.

Problemas comuns

  • A aplicação foi criada com Sandbox em vez de Production — nunca vai encontrar o teu banco real.
  • O formulário da aplicação não foi submetido porque Privacy URL ou Terms URL ficaram vazios.
  • Foi clicado Request activation em vez de Activate by linking accounts, iniciando por engano o caminho de verificação empresarial.
  • O ficheiro .pem descarregado perdeu-se antes de ser copiado para a WonderMoney.

Para ajuda com qualquer um destes casos, consulta Problemas de ligação bancária.

Ligações relacionadas

Nesta página