Página final
Quando é indicado o endereço de callback no campo “UF”, o “Pay by link” assume esse endereço como a página final pretendida, e não as páginas padrão da nossa solução.
Analisemos as várias situações possíveis. Para efeitos de exemplificação, vamos partir do pressuposto que o “UF” é: https://exemplo.com/lusopaycallback/
No caso dos meios de pagamento referências Multibanco e Payshop, ao carregar no link que fecha a página, serão enviados como parâmetros para o link previamente indicado, o “PID”, o “OID”, o valor (“AMT”), um código com o método de pagamento utilizado e o estado da operação, conforme o seguinte exemplo:
https://exemplo.com/lusopaycallback/?PID=$public_id&OID=$order_id&CPM=$method_code&S=pending
No caso de pagamentos por MB Way recusados/falhados, o reencaminhamento será para um link com o seguinte formato e parâmetros:
https://exemplo.com/lusopaycallback/?PID=$public_id&OID=$order_id&CPM=$method_code&S=canceled
No caso de pagamentos por MB Way com sucesso, o reencaminhamento será para um link com o seguinte formato e parâmetros:
https://exemplo.com/lusopaycallback/?PID=$public_id&OID=$order_id&CPM=$method_code&S=paid
A captação destes parâmetros permite a correta identificação para tratamento da resposta com total liberdade por parte de quem implementa.
Em caso de pagamento por MB Way, se o pagador fechar a página durante os quatro minutos disponíveis para concluir a operação, será possível receber a notificação do estado do pagamento através de uma notificação via POST que receberá da nossa parte. A comunicação segue pelos endereços IP indicados no nosso manual de callback.
O código enviado por $method_code acontece de forma automática da nossa solução, por meio de uma atribuição com base na tabela explicitada no capítulo 5.2.
Exemplo de endereço final completo (sem atender a encriptação e codificação):
https://exemplo.com/lusopaycallback/?PID=cliente07&OID=1213&CPM=P3&S=pending
É fundamental certificar-se de que forma quer processar, do seu lado, a informação. Quer por meio do que é enviado como parâmetro pela nossa “página final”, ou pela notificação via POST, mencionado acima, e explicitado no nosso manual de callback, cujo download pode ser feito aqui. Desta forma, evita eventuais duplicações na comunicação e que podem induzir em erro no momento de tratar e processar os dados, como a ilusão de pagamentos duplicados.
Nome da variável | Exemplo |
PID | cliente1 |
OID | 93713461 |
AMT | 2.50 |
CPM | P3 |
S | Capítulo 5.7 |
No caso de não ser indicado um endereço de callback, como supramencionado, as páginas finais serão as padrão da nossa plataforma (uma página final, no caso de sucesso da operação de pagamento, ou de erro, no caso de existir alguma falha, onde o erro estará identificado na mesma).
5.5.1 Tentar Novamente
Para pagamentos MB Way, Cartão de Crédito, Google Pay ou Apple Pay que falhem, por serem de atualização dinâmica, o pagador será redirecionado para uma página que permitirá tentar novamente. Caso tenha sido passado, na geração do URL, o parâmetro “UF”, aparecerá ainda um botão para o pagador voltar à loja. Caso, em pagamentos por Cartões de Crédito, tenha sido inserido um cartão que viole autenticações 3DSecure específicas, essa opção de pagamento desaparecerá.