Receber pagamentos com Global Payments
A Global Payments é um prestador de pagamentos internacional, compatível com o Desjardins (Quebeque). Os seus utilizadores pagam com cartão bancário numa página de pagamento segura da Global Payments, que também gere a autenticação 3-D Secure. As comissões são as previstas no seu contrato com a Global Payments: o OpenResa não cobra qualquer comissão sobre estes pagamentos.
Pré-requisitos
Para receber pagamentos reais, a sua organização tem de ter uma conta de comerciante Global Payments, por exemplo através do Desjardins, no Quebeque. O seu gestor de conta fornece-lhe então duas credenciais próprias da sua aplicação: uma App ID e uma App Key.
Para experimentar a gateway de pagamento antes de assinar, crie gratuitamente uma conta no portal de programadores da Global Payments (developer.globalpayments.com). É criada uma aplicação de teste, com a sua própria App ID e a sua própria App Key.
Configurar a Global Payments numa conta de faturação
Cada conta de faturação tem a sua própria gateway de pagamento: pode reservar a Global Payments para uma parte das suas atividades e deixar as restantes noutra conta.
- Aceda a Administração›Configurações›Faturação›Contas de faturação, abra a conta de faturação em causa e abra o separador Pagamentos.
- Ative Pagamentos online e selecione Global Payments na lista de gateways de pagamento.
- Cole a sua App ID e a sua App Key. A App Key é guardada de forma encriptada e nunca mais volta a ser apresentada por inteiro.
- Deixe Endereço da API em
apis.globalpay.com. Escolhaapis.eu.globalpay.comapenas se a Global Payments lho tiver indicado. - Deixe Nome da conta vazio: o OpenResa escolhe automaticamente a conta a utilizar (ver mais abaixo).
- Assinale Ambiente de teste (sandbox) se introduzir as credenciais de uma aplicação de teste.
- Clique em Guardar e, em seguida, em Testar a conexão.
Não é necessário registar nenhum endereço de notificação no seu espaço Global Payments: o OpenResa transmite automaticamente os seus endereços de retorno em cada pagamento. Uma ligação Ajuda online no formulário retoma estes passos.
Se o teste indicar que as credenciais foram recusadas, verifique primeiro a caixa do ambiente de teste. As credenciais de teste só funcionam com a caixa assinalada. As credenciais de produção só funcionam com a caixa desmarcada.
Escolher a conta de processamento
Uma aplicação Global Payments pode agrupar várias contas de processamento de pagamentos. Quando Nome da conta está vazio, o OpenResa escolhe a única conta disponível ou, se houver várias, a única conta reservada à página de pagamento, cujo nome termina em _hpp. O teste de ligação indica-lhe a conta escolhida, por exemplo Ligação Global Payments OK — conta de processamento selecionada automaticamente: transaction_processing_hpp.
Se o OpenResa não conseguir escolher sozinho, a mensagem do teste lista as contas disponíveis. Copie o nome da conta que a Global Payments lhe indicou para Nome da conta, guarde e volte a executar o teste.
Experimentar com o ambiente de teste
Com as credenciais de uma aplicação de teste e a caixa Ambiente de teste (sandbox) assinalada, os pagamentos são fictícios: nenhum cartão é debitado, e as encomendas pagas geram faturas da série SPECIMEN, sem valor contabilístico.
Para fazer um pagamento de teste, pague uma encomenda com o cartão de teste Visa 4263970000005262, a data de validade 05/39 e o código de segurança 599: o pagamento é aceite. Outros cartões de teste estão descritos na documentação da Global Payments.
Para passar para produção, substitua a App ID e a App Key pelas suas credenciais de produção, desmarque a caixa, guarde e volte a executar o teste de ligação.
Compreender o pagamento do lado do utilizador
No momento de pagar, o utilizador escolhe Pagamento online, apresentado com a menção via Global Payments, e é depois redirecionado para a página de pagamento da Global Payments, em francês ou em inglês consoante o seu idioma. Aí, introduz os dados do cartão e confirma, se o banco o pedir, com a autenticação 3-D Secure.
Em seguida, regressa ao OpenResa, que aguarda a confirmação da Global Payments: a mensagem Pagamento validado é apresentada, em geral, cerca de dez segundos após o pagamento. O OpenResa envia-lhe então, como para qualquer gateway de pagamento, a confirmação e a fatura.
Aplicam-se algumas regras próprias da Global Payments:
- Endereço de e-mail. A Global Payments exige o endereço de e-mail de quem paga. O utilizador tem, por isso, de ter um endereço válido, com 50 caracteres no máximo, na encomenda ou na conta. Caso contrário, o pagamento online é-lhe recusado com a mensagem É necessário um endereço de e-mail válido para pagar online. Verifique a sua conta.
- Moeda. O pagamento é feito na moeda da encomenda, por exemplo em dólares canadianos para um clube do Quebeque. Esta moeda tem de estar ativada na sua conta Global Payments: caso contrário, o utilizador vê uma mensagem de indisponibilidade e o administrador é alertado após várias falhas.
- Uma tentativa por página. Após uma recusa do cartão, o utilizador regressa ao OpenResa e volta a iniciar o pagamento: é criada uma nova página de pagamento.
A página de pagamento da Global Payments permanece válida durante 24 horas. Se o utilizador a abandonar, a encomenda fica pendente de pagamento e pode voltar a pagá-la, através da Global Payments ou de outro meio de pagamento que proponha.
Encontrar um pagamento
No seu portal Global Payments, cada pagamento tem uma referência que combina o número da encomenda, sem hífenes, e o número da tentativa de pagamento: BJ2026000123T15349533 corresponde, por exemplo, à encomenda 2026-000123. Pesquise este número de encomenda em Administração›Painel de controlo›Faturação›Faturas & transações para a abrir.
No detalhe da encomenda, a transação indica ID de transação da Global Payments, Número de autorização e Referência. A opção Registo de eventos da conta de faturação lista as respostas recebidas da Global Payments e o resultado consultado, com o motivo de uma eventual falha. Numa linha com falha, Repetir volta a consultar o pagamento junto da Global Payments e regista-o se tiver sido concluído.
Reembolsar um pagamento
O reembolso é iniciado a partir de Administração›Painel de controlo›Faturação›Faturas & transações: abra a encomenda, clique em Reembolsar e escolha um reembolso total ou parcial. Com o bloco Global Payments, o OpenResa atualiza a encomenda e transmite o reembolso à Global Payments, que credita novamente o cartão de quem pagou.
Um reembolso total retira os itens entregues (créditos devolvidos, subscrição revogada) e passa a encomenda para reembolsada. Um reembolso parcial mantém a encomenda paga e reduz apenas o montante recebido. A Global Payments não aceita reembolsar mais do que o montante do pagamento.
Se a Global Payments não confirmar o reembolso, por exemplo em caso de falha de ligação, a encomenda é atualizada na mesma e uma mensagem Reembolso a verificar do lado de Global Payments convida-o a verificar no seu portal se o reembolso foi efetivamente feito e, caso contrário, a fazê-lo.
