ifthenpay¶
Fique a saber como configurar e utilizar a o nosso conector ifthenpay
Importante
O conector ifthenpay não está disponível na loja Odoo, para ter acesso ao mesmo terá de pedir aos nossos serviços que façam a sua instalação e ativação na sua base de dados
Depois pode começar a seguir os passos que se seguem para proceder à configuração e utilização
Configuração¶
Comece por criar uma conta na plataforma ifthenpay
Se não foi criado um utilizador de backoffice na adesão, pode criar um aqui
Faça login no backoffice do ifthenpay
Recolha as suas credenciais para registo no Odoo
Nota
Na comunicação que recebeu da ifthenpay aquando da criação da conta, deve ter recebido um ficheiro .pdf que continha informação dos campos Entidade, Subentidade e Chave de Backoffice
Caso já não tenha acesso a esse documento, no menu de navegação do lado esquerdo da página aceda a
No topo da página, selecione a conta de Multibanco, no campo Conta os dígitos associados costumam seguir o padrão Entidade | Subentidade
Aceda ao Provedor de Pagamento em Odoo
Nota
Depois de instalado e ativo o conector ifthenpay, aceda à app Faturação / Contabilidade (dependendo respetivamente se tem versão Community ou Enterprise do Odoo), vá ao menu de Configuração e no separador Pagamentos Online selecione a opção Provedores de Pagamento.
Importante
Não pode criar novos provedores de pagamentos, no entanto caso precise (por exemplo estando a operar em ambiente multi-empresa ou ter multiplas contas para a mesma empresa) pode duplicar um dos existentes e mudar o nome e/ou empresa associada
Vai poder ver 2 novos provedores de pagamento associados ao ifthenpay, pode ativar apenas um deles, ou ambos
Independentemente do método vai poder escolher o Estado
Desativado, não vai estar disponível para utilização
Ativado, vai estar disponível para utilização
Perigo
Não utilize o Modo de Teste, devido a limitações do sistema ifthenpay, o modo de teste funciona como se o conector estivesse ativo.
Faz comunicação de mensasgens e permite que sejam recebidos valores com as referências criadas
Também pode escolher a que Empresa e Website está associado
Na aba Configuração pode definir qual o diário onde quer que os movimentos fiquem registados e algumas modalidades de restrições como:
Valor Máximo da transação
Moeda para que está disponível
Países onde vai estar disponível o método de pagamento
5.1. Configuração MB Way
Nota
Além dos dados anteriores ainda vai preciar de mais dados do backoffice do ifthenpay, volte à página com a informação do contrato e selecione a conta MB Way
No campo Conta os dígitos associados costumam seguir o padrão MBWAY | Chave MBWAY, só precisa da Chave MBWAY
Na aba Credenciais é onde vai poder introduzir a informação que consta do backoffice do ifthenpay
Entidade MB
Subentidade MB
Chave de Backoffice
Chave MBWAY
Deve ainda preencher o campo Descrição MBWAY, com o nome curto da sua empresa para que os seus clientes o consigam identificar na plataforma quando for pedido o pagamento.
Em seguida deve gerar uma Chave Anti-phishing para isso vai ter de escrever uma chave à sua escolha no campo reservado para o efeito e depois carregar no botão próprio para a converter
Insira o valor no respetivo campo dentro do backoffice do ifthenpay
O Callback URL é usado para o ifthenpay comunicar ao Odoo o estado do pagamento, precisa de copiar este valor do seu Odoo para o backoffice do ifthenpay e carregar em ATIVAR.
Quando solicitado, volte a inserir a Chave de Backoffice e depois Confirmar
Na aba Mensagens pode configurar diversos tipos de informação como:
Mensagem de Ajuda, que informa o utilizador na utilização da forma de pagamento
Mensagem Pendente, é a mensagem que o utilizador vai ver quando é gerado o pagamento, note que esta mensagem tem um valor dinâmico que tem de ficar {time_limit}, no entanto pode alterar o resto da mensagem
Mensagem de Conclusão, esta mensagem aparece quando o utilizador concluí o pagamento
Mensagem de Cancelamento, esta mensagem é exibida se o pagamento for cancelado
Importante
O método de MB Way apenas pode ser usado no website para que o cliente possa inserir o nº de telefone associado ao pagamento
5.2. Configuração Multibanco
Nota
Na aba Credenciais é onde vai poder introduzir a informação que consta do backoffice do ifthenpay
Entidade MB
Subentidade MB
Chave de Backoffice
Em seguida deve gerar uma Chave Anti-phishing para isso vai ter de escrever uma chave à sua escolha no campo reservado para o efeito e depois carregar no botão próprio para a converter
Insira o valor no respetivo campo dentro do backoffice do ifthenpay
O Callback URL é usado para o ifthenpay comunicar ao Odoo o estado do pagamento, precisa de copiar este valor do seu Odoo para o backoffice do ifthenpay e carregar em ATIVAR.
Quando solicitado, volte a inserir a Chave de Backoffice e depois Confirmar
Na aba Mensagens pode configurar diversos tipos de informação como:
Mensagem de Ajuda, que informa o utilizador na utilização da forma de pagamento
Mensagem Pendente, é a mensagem que o utilizador vai ver quando é gerado o pagamento, note que esta mensagem tem três valores dinâmicos que têm de ficar {entity}, {reference}, {amount}, no entanto pode alterar o resto da mensagem
Mensagem de Conclusão, esta mensagem aparece quando o utilizador conclui o pagamento
Mensagem de Cancelamento, esta mensagem é exibida se o pagamento for cancelado
Importante
Na app Configurações do Odoo, no separador Faturação / Contabilidade (dependendo respetivamente se tem versão Community ou Enterprise do Odoo), tem uma nova opção com valor multi-empresa na secção Pagamentos de Clientes, onde pode definir qual é o Provedor de Pagamento MB padrão.
Além de poder escolher o provedor padrão, também pode escolher qual o seu comportamento padrão:
All Customers, ao criar uma fatura, o campo respetivo vai ser pré-preenchido e ao confirmar a fatura, vai ser gerada de imediato uma referência para pagamento
No caso de o cliente ser uma exceção, não vai pré-preencher o campo na fatura nem gerar a referência ao confirmar a mesma
No Customers, ao criar uma fatura, o campo respetivo não é pre-preenchido e ao confirmar a fatura, não vai acontecer nada a não ser que o cliente seja uma exceção
No caso de o cliente ser uma exceção, vai usar o provedor padrão para pré-preencher o campo na fatura e gerar uma referência ao confirmar a mesma
Utilização¶
Dica
Decida qual é o comportamento mais benéfico para si em termos de casos gerais e exceções
Dica
Pode tratar as exceções mencionadas no final das configurações na aba Faturação / Contabilidade do Contacto
Sempre que faça uma fatura a regra que se aplica vai preencher ou não o campo respetivo, no entanto pode documento a documento mudar o valor lá inserido
Independentemente do método escolhido, pode sempre emitir uma referência de pagamento manual no menu Ação do documento.
Se optar pela opção de Gerar Link para Pagamento vai poder enviar o link, para o cliente escolher a modalidade que prefere
Se optar pela opção de Gear Referências Multibanco vai poder escolher quantos dias essa referência vai ficar ativa. No entanto deve ter em conta que vai ser utilizado o provedor escolhido na fatura.
Depois de emitida uma referência para pagamento, pode consultar o estado de cada transação na aba Transações
Se carregar numa das transações, vai poder ver um resumo da mesma nomeadamente a referência
Depois de o cliente efetuar o pagamento e este for validado pelo ifthenpay e comunicado por Callback de novo ao Odoo, vai acontecer uma das seguintes situações:
Se apenas tiver a app de Faturação instalada, a fatura passa logo ao estado de Pago como se o recibo tivesse sido emitido
Se tiver instalada a app de Contabilidade, a fatura passa ao estado de Em pagamento como se o recibo tivesse sido emitido, no entanto, com a app de Contabilidade ainda falta fazer a reconciliação bancária
Esta alteração acontece pela forma como ambas as apps lidam com a reconciliação de documentos
Dica
Sincronização manual
Se por algum motivo estiver a ter problemas com o seu Callback, ou pretender fazer sincronização de movimentos anteriores, pode fazer sincronização manual no Provedor de Pagamento
Para o fazer aceda à app Faturação / Contabilidade (dependendo respetivamente se tem versão Community ou Enterprise do Odoo), vá ao menu de Configuração e no separador Pagamentos Online selecione a opção Provedores de Pagamento.
No separador Sincronização vai ter um botão para o efeito, no final da sincronização a data vai ser guardada
Importante
A opção de sincronização manual apenas funciona para o provedor de Multibanco