Geração do link offline

Gerar um link por via offline implica a construção de um URL com um conjunto de parâmetros específicos. Esta abordagem permite a criação de links de pagamento sem a necessidade de uma ligação à internet, sendo que, quando o URL é posteriormente aberto no nosso serviço, o sistema identifica o utilizador através do identificador público de conta (PID).

Lista de Parâmetros

Para construir o URL offline, é necessário incluir os seguintes parâmetros:

• T: Tipo de geração, deve ser sempre "API".

• PN: Nome do pagador.

• PE: E-mail do pagador.

• BA: Morada do pagador,

• BZC: Código postal do pagador,

• BC: Cidade do pagador,

• BCC: Código do país do pagador ou país do pagador,

• OID: ID do pagamento.

• AMT: Valor do pagamento.

• OP: Tipo de operação

• PID: Identificador público.

• MSG: Descritivo do pagamento.

• CST: Nome do cliente.

• W: URL do website do beneficiário do pagamento.

• UF: URL final a ser utilizado após o pagamento (opcional).

• L: Código ISO da língua atual (ex.: pt_PT para português).

• CUR: Código ISO da moeda atual (ex.: EUR para euros).

• ED: Data limite de pagamento (para pagamentos Multibanco por ficheiro).

• OL: Indica se o link é de utilização única (booleano true ou false).

• PYM: Opções de métodos de pagamento visíveis na página de pagamento (ex.: P2|P3).

• ECF: Campo opcional, de configuração externa, para permitir cronómetro na página.

• TID: Identificação do terminal MB Way atribuído e comunicado pela lusopay (quando aplicável).

Para cada campo, os valores aceites e exemplos específicos estão detalhados no Capítulo 5. Estes parâmetros devem ser codificados no formato de query string e, posteriormente, em base64, para uso no URL final.

Exemplo do URL descodificado:

https://pay.lusopay.com/paybylink_test/v3/offline_engine.php?data=T=API&L=pt_PT&CUR=EUR&PID=cliente7&W=http://lusopay.com&CST=ClienteSete&OID=#1234&OP=1&AMT=3.00&MSG=Pagamento+de+Servico&PN=Exemplo&OL=true&ED=2025-06-28&UF=https://www.lusopay.com&PYM=P2|P1

Codificação em Base64

Para garantir a segurança e compatibilidade, o URL construído deve ser codificado em base64. Esta codificação transforma a query string num formato seguro para transferência online. Por exemplo, o URL acima, codificado em base64, será incluído no campo data do URL final.

Integração na Aplicação

Quando o URL offline é gerado e incluído no campo data, este pode ser partilhado com o pagador. Ao abrir o link, o nosso sistema descodifica o conteúdo de data, valida os respetivos parâmetros e redireciona para a página de pagamento configurada, com base nos detalhes fornecidos, através de um novo URL seguro, codificado e encriptado.