Saltar para o conteúdo principal
GoCardless

GoCardless bank verification no Odoo: o que verifica o botão Testar a ligação

No Odoo, a verificação da tua conta GoCardless é um botão: Testar a ligação (Test connection) pede ao GoCardless o credor da conta, guarda o estado de verificação que ele devolve e avisa se o débito direto SEPA está ativo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 17 de novembro de 2026

O essencial

Módulo
GoCardless
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

O problema: sem verificação, o GoCardless não deixa cobrar nem receber o dinheiro

Segundo a documentação do GoCardless, uma conta tem de estar verificada antes de começar a cobrar e de receber as suas liquidações; o módulo lembra-o na ajuda do seu campo de verificação: o GoCardless só paga a contas verificadas. Por isso o conector não se fica por confirmar que as credenciais funcionam: ao testar a ligação guarda também o estado de verificação que o GoCardless devolve.

Convém ter clara a fronteira: o botão não verifica nenhuma conta bancária. Lê o credor da tua conta GoCardless, regista o estado de verificação que o GoCardless lhe atribui e avisa sobre o esquema SEPA. A verificação em si faz-se com o GoCardless, e o Odoo mostra em que ponto está, como se explica mais abaixo.

Para quem ainda não usa o Odoo, a ideia é esta: a ligação ao GoCardless vive na ficha de um provedor de pagamento, e a partir dessa mesma ficha pergunta-se ao GoCardless quem é o credor da conta e se pode cobrar débitos diretos SEPA.

How to stop copy-pasting between apps (Odoo)
Vídeo: How to stop copy-pasting between apps (Odoo) (vídeo em inglês)

Onde está o botão e quando aparece

O botão Testar a ligação (Test connection) está na ficha do provedor de pagamento GoCardless. Só se vê quando o provedor é o do GoCardless e, além disso, o campo Estado (Status) indica que a ligação está feita ou o campo Ligação (Connection) está em modo direto. Com os valores por defeito de um provedor sem ligar, o botão não aparece.

Essa condição é a mesma no Odoo 17, 18, 19 e 20. Tudo o que se segue é o comportamento do código do Odoo 20.

Ficha do provedor de pagamento GoCardless no Odoo, em modo de teste e com dados de demonstração, com a interface em inglês: estado Connected, o credor verificado, o URL do webhook e o botão Test connection
Separador de configuração do provedor GoCardless (dados de demonstração, interface em inglês), com o botão Test connection

O que faz ao premi-lo, por ordem

  1. Pede ao GoCardless o credor da conta. Se a chamada falhar, o teste pára com a mensagem de erro correspondente.
  2. Se o GoCardless não devolver nenhum, o teste pára com o aviso Esta conta GoCardless ainda não tem nenhum credor configurado. (This GoCardless account has no creditor set up yet.) e não se guarda nada do que o teste ia alterar.
  3. Se houver credor, guarda o seu identificador e o seu estado de verificação no provedor. Se o GoCardless devolver um estado que o módulo não reconhece, o estado fica vazio.
  4. Se a ligação estiver em modo direto, marca a ligação como ligada e, se o provedor ainda não tinha data do último evento, coloca-lhe a data e hora atuais.
  5. Olha para os esquemas do credor e mostra o aviso de ligação que corresponda, consoante haja ou não esquema SEPA.

O aviso aparece como uma notificação de sucesso que não fica fixa no ecrã.

Alguns casos que o teste pode dar

CasoO que vêsO que faz o módulo
A conta tem credor e esquema SEPALigado a … (…). O débito direto SEPA está ativo. (Connected to … (…). SEPA Direct Debit is enabled.)Guarda o credor e o seu estado de verificação. As reticências são o nome e o país do credor.
O credor não tem esquema SEPALigado a …, mas este credor ainda não tem o esquema SEPA ativo, pelo que não é possível cobrar débitos diretos SEPA. (Connected to …, but this creditor has no SEPA scheme enabled yet, so SEPA Direct Debit cannot be collected.)Guarda na mesma o credor e o seu estado de verificação. As reticências são o nome do credor.
A conta não tem credorEsta conta GoCardless ainda não tem nenhum credor configurado.O teste pára e não se guarda nada.
Provedor sem ligar e com os valores por defeitoO botão não se vêO botão não está disponível na ficha.
Ligação em modo diretoO botão vê-se mesmo que Estado não indique que a ligação está feitaDepois de encontrar o credor, marca a ligação como ligada e, se faltava, coloca a data do último evento.

Os avisos de ligação não falam da verificação: o estado de verificação guarda-se no provedor, mas o aviso só informa sobre o credor e o SEPA. Por isso convém ler o aviso inteiro: um credor sem esquema SEPA também aparece como ligado, mas o texto diz que não é possível cobrar débitos diretos SEPA.

Onde vê o estado da verificação

O que o teste guarda vê-se na ficha do provedor, no campo Verificação (Verification), que só aparece quando tem valor. Pode dizer «Verificada», «Em revisão pela GoCardless» ou «Ação necessária». Com «Ação necessária» aparece também a ligação «Concluir a verificação» (Finish verification), que leva ao processo de verificação do GoCardless: o da conta real ou o do sandbox, conforme o ambiente. O campo é atualizado sempre que testa a ligação.

O que faz o conector à volta do teste

O teste usa o mesmo ponto de entrada que as restantes chamadas do módulo ao GoCardless. Do seu código saem estes comportamentos:

  • Consoante o provedor esteja em produção ou em testes, o módulo chama um endereço ou outro do GoCardless.
  • Cada chamada leva a versão da API que o GoCardless exige.
  • Se a chamada for um envio com chave de idempotência e a ligação se cortar ou o GoCardless não responder, o módulo reenvia-o com a mesma chave. Se o GoCardless responder que esse recurso já existia de uma tentativa anterior, o módulo pode adotar esse recurso em vez de dar erro.
  • Se o GoCardless limitar o ritmo das chamadas, o módulo espera e volta a tentar, um número limitado de vezes.

O conector vem com a subscrição do FlexigoTech Cloud. O preço e o plano estão na página do módulo e na ficha do Odoo Apps.

Se ainda não usas o Odoo

Se hoje cobras com o GoCardless e queres ter a ligação, a verificação da conta e as cobranças dentro do mesmo programa de gestão, a FlexigoTech ajuda-te com a implementação do Odoo: implementamos o Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida. Além disso, o conector do GoCardless está disponível como módulo, e podes começar por testar a ligação com a tua conta de testes.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes