Saltar para o conteúdo
Tejobit
Logótipo IfthenPay

Pagamentos

Integração IfthenPay

Gera referências Multibanco e pedidos MB WAY e trata o callback de pagamento para fechar encomendas e faturas sozinho.

Pedir esta integração Ver todas as integrações

Visão geral

IfthenPay

A IfthenPay é um dos gateways mais usados em Portugal para receber por referência Multibanco, MB WAY, Payshop e cartão. Cada conta tem entidades e subentidades, e cada método de pagamento tem a sua chave própria.

A Tejobit liga a IfthenPay ao sistema onde nasce a cobrança: uma loja online, uma área de reservas, um back-office de inscrições. A ligação pede a referência ou o pagamento MB WAY no momento certo, envia os dados ao cliente e fica à escuta do callback que a IfthenPay chama quando o dinheiro entra.

Quando chega a confirmação, a encomenda muda de estado, o software de faturação certificado emite o documento e o cliente recebe o recibo. Ninguém tem de abrir o backoffice da IfthenPay para ver se uma referência foi paga.

Casos de uso

Para que serve

  • Loja online que gera uma referência Multibanco no checkout e só envia a encomenda quando o pagamento é confirmado
  • Escola ou centro de explicações que cobra mensalidades com referências com data limite
  • Alojamento local que pede o sinal por MB WAY logo a seguir à reserva
  • Associação ou clube que envia referências de quotas e atualiza a lista de sócios com quotas em dia
  • Ginásio que manda o pedido MB WAY para o telemóvel do aluno na renovação da mensalidade
IN

O que a ligação escuta

  • Callback de pagamento da IfthenPay, validado pela chave anti-phishing
  • Nova encomenda, inscrição ou reserva no sistema de origem que exige cobrança
  • Mudança de estado de um pedido MB WAY (aceite, recusado ou expirado)
  • Referências com validade a terminar, verificadas de forma periódica
OUT

O que a ligação faz

  • Gerar referências Multibanco por entidade e subentidade, com valor e validade
  • Enviar pedidos MB WAY para o número de telemóvel do cliente
  • Marcar a encomenda ou a reserva como paga e registar a data do pagamento
  • Pedir a emissão da fatura-recibo ao software de faturação
  • Avisar a equipa quando um pagamento falha ou uma referência expira

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Contrato ativo com a IfthenPay e as chaves Multibanco e MB WAY que pretende usar
  • Pedido à IfthenPay para ativar o callback, com a chave anti-phishing definida
  • Regras de validade das referências e o que acontece a uma encomenda não paga
  • Acesso ao sistema de origem (loja, reservas ou back-office)

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A ativação do callback é feita pelo suporte da IfthenPay, não é imediata
  • Um pedido MB WAY expira poucos minutos depois de enviado, se o cliente não o aceitar
  • A IfthenPay recebe o pagamento, mas não emite faturas: isso fica no software certificado

Perguntas frequentes

Antes de começar

O callback da IfthenPay é seguro?

O callback traz uma chave anti-phishing que só a conta conhece. A ligação rejeita qualquer pedido que não a traga e confirma o valor e a referência antes de dar a encomenda como paga.

Posso usar Multibanco e MB WAY na mesma ligação?

Sim. Cada método tem a sua chave na IfthenPay, e a ligação escolhe o método conforme a opção do cliente no checkout ou na fatura.

E se o cliente pagar uma referência já expirada?

Depende da configuração da entidade. A ligação regista o pagamento que chega e sinaliza o caso à equipa, para decidir se a encomenda segue ou se há reembolso.

A fatura é emitida pela IfthenPay?

Não. A IfthenPay trata do recebimento. A fatura é emitida e comunicada à AT pelo programa de faturação certificado, que a ligação alimenta com os dados do pagamento.

Integrações relacionadas

Ver todas as integrações

Ativar a integração IfthenPay?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com