Saltar para o conteúdo principal
GoCardless

GoCardless sandbox no Odoo: que ambiente usa e como passar à conta real

Com o conector GoCardless para Odoo, o provedor de pagamento fica ligado a um único ambiente, sandbox ou conta real, conforme a definição Produção no momento de ligar (no Odoo 20; no 17, 18 e 19, conforme o campo «Estado» do provedor). Se alterar essa definição depois, o módulo não envia nada à GoCardless e pede-lhe que desligue e volte a ligar.

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
6 min

O que o Odoo centraliza e a que ambiente fica ligado o provedor

A GoCardless oferece um sandbox, com o seu próprio endereço de API (https://api-sandbox.gocardless.com/), e a conta real. O token que o provedor de pagamento guarda pertence a um dos dois, e misturá-los só dá um erro que não explica o motivo. Por isso, antes de enviar um pedido à GoCardless, o conector compara o ambiente do token com o modo em que o provedor está neste momento.

No Odoo 20, a ficha do provedor de pagamento GoCardless reúne a definição Produção (Live) e o ambiente a que se ligou; os mandatos dos seus clientes ficam guardados como métodos de pagamento. O campo Ambiente ligado (Connected Environment) está na ficha do provedor de pagamento e é só de leitura. Com os valores por defeito não se vê: fica oculto enquanto o provedor não tem um ambiente ligado. Os seus valores são Sandbox e Produção, e a sua ajuda diz: A que ambiente GoCardless pertence o token guardado. (Which GoCardless environment the stored token belongs to.). É preenchido pelo próprio módulo (não pelo utilizador) e esvaziado pelo botão Desligar (Disconnect).

Provedor de pagamento GoCardless em modo de teste, separador de configuração, com as opções de ligar a conta ou colar um token de acesso (avançado), o estado ligado e o botão de testar a ligação
Separador de configuração do provedor GoCardless, com dados de demonstração e a interface em inglês
How to stop copy-pasting between apps (Odoo)
Vídeo: How to stop copy-pasting between apps (Odoo) (vídeo em inglês)

Sandbox versus conta real

AspetoSandboxConta real
Definição ProduçãoDesativadaAtivada
Endereço da APIhttps://api-sandbox.gocardless.com/Outro diferente: o módulo usa um endereço para cada modo
Ambiente ligado, quando o módulo o preenche ao ligarSandboxProdução
Se alterar Produção depois de ligarO módulo não envia nada e pede para desligar e voltar a ligarO mesmo
Botão Reativar mandato (sandbox) (Reinstate mandate (sandbox)) no Odoo 20Vê-se se o mandato estiver cancelado, falhado ou caducadoNão se vê; se se chegar à ação, esta pára com um aviso
Cópia da base de dadosO módulo não usa a ligação da base de dados original; numa cópia de testes, cole um token de sandbox no modo avançado ou ligue com Produção desativadaO módulo não usa a conta real numa cópia até se premir Esta base de dados cobra a partir de agora (This database charges from now on)

O que acontece se mudar o modo depois de ligar

O módulo compara o ambiente guardado em Ambiente ligado com o que a definição Produção indica neste momento. Se não coincidirem, não envia nada à GoCardless e pára com este aviso: Este provedor foi ligado ao ambiente … da GoCardless. Desligue-o e ligue-o novamente depois de alterar «Live». (This provider was connected to the GoCardless …. Disconnect it and connect again after changing its Live setting.). No lugar das reticências aparece o ambiente a que o provedor foi ligado.

Pode encontrá-lo ao premir Reativar mandato (sandbox) com uma ligação feita em produção e a definição já desativada. A saída é a que o próprio aviso indica: desligar e ligar de novo.

No Odoo 17, 18 e 19 não existe a definição «Produção» (Live): faz esse papel o campo «Estado» do provedor, com os valores «Desabilitado», «Habilitado» e «Modo de Teste». Nessas versões este aviso termina com «Desligue-o e ligue-o novamente depois de alterar o seu estado.», o aviso de uma cópia da base de dados propõe ligar em «Modo de Teste» em vez de com «Produção» desativada, e para passar à conta real coloca-se o «Estado» em «Habilitado».

O que faz o botão «Reativar mandato (sandbox)»

O botão está na vista do mandato guardado, o método de pagamento GoCardless. No Odoo 20 fica oculto se o método não for da GoCardless, se o provedor estiver em produção ou se o mandato não estiver cancelado, falhado nem caducado. O campo Estado do mandato (Mandate Status) não aparece em nenhuma vista, pelo que o botão aparece ou não consoante um estado que não consulta no ecrã. No Odoo 17, 18 e 19 a condição olha para o estado do provedor e oculta o botão quando está ativado, em vez da definição de produção.

Ao premi-lo, o módulo verifica o seguinte e, se estiver tudo bem, pede a reativação:

  1. Se o provedor estiver em produção, pára com A GoCardless não permite a esta ligação reativar um mandato em produção. Peça ao cliente um novo mandato. (GoCardless does not let this connection reinstate a live mandate. Ask the customer for a new mandate.).
  2. Se o estado do mandato não puder ser reativado, pára e o cliente tem de assinar um novo mandato.
  3. Caso contrário, pede à GoCardless que reative o mandato, em vez de fazer o cliente assinar de novo. Esse pedido passa antes pela verificação do ambiente ligado: se não coincidir com a definição Produção, pára com o aviso da secção anterior.
  4. Marca o mandato como pendente de reativação e, se tiver contacto associado, deixa uma nota nesse contacto: Foi pedida a reativação do mandato da GoCardless. Não poderá ser usado até o banco o confirmar. (Reinstatement of the GoCardless mandate requested. It stays unusable until the bank confirms it.).

A reativação não é imediata: o banco do cliente tem de a aceitar, e o mandato fica inativo até a GoCardless o confirmar.

Lista de métodos de pagamento guardados com mandatos SEPA da GoCardless de vários parceiros, com o método SEPA Direct Debit, o provedor e a referência do mandato
Mandatos guardados como métodos de pagamento, com dados de demonstração de um ginásio inventado e a interface em inglês

Como se passa à conta real

  1. Altere a definição Produção do provedor (no Odoo 17, 18 e 19, coloque o seu «Estado» em «Habilitado»).
  2. Desligue o provedor, como pede o aviso (o botão Desligar esvazia Ambiente ligado).
  3. Volte a ligar: com a ligação de dois cliques ou, no modo avançado, colando um token de acesso da conta real.

Se a base de dados que vai cobrar com a conta real substitui outra, existe o botão Esta base de dados cobra a partir de agora. Pede confirmação e exige ter Produção ativada e o token de acesso de produção dessa base de dados. Se faltar algum desses elementos, pára com Primeiro ative «Produção» e cole o token de acesso de produção desta base de dados. (Turn Live on and paste this database's live access token first.). No Odoo 17, 18 e 19, esse aviso pede em vez disso que coloque o provedor em «Habilitado» e cole o token de acesso de produção desta base de dados. No modo avançado, a outra base de dados pode continuar a cobrar até desativar o seu token de acesso na GoCardless.

Como a FlexigoTech o ajuda

O conector GoCardless vem com a subscrição do FlexigoTech Cloud; os preços, sem IVA, estão na ficha do Odoo Apps e na página do módulo. Se ainda não trabalha com Odoo, a FlexigoTech implementa o Odoo nas versões 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, pelo que pode testar a GoCardless em sandbox antes de passar à conta real.

Continue a ler

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

Fontes

  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): const.py
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): views/payment_token_views.xml
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_token.py
  • flexigotech.com/en/services.html
  • Código do módulo: flexigo_payment_gocardless 20.0 (6fe1a716): __manifest__.py