Receber pagamentos com Global Payments

A Global Payments é uma provedora de pagamentos internacional, compatível com o Desjardins (Quebec). Seus usuários pagam com cartão bancário em uma página de pagamento segura da Global Payments, que também cuida da autenticação 3-D Secure. As tarifas são as do seu contrato com a Global Payments: o OpenResa não cobra nenhuma comissão sobre esses pagamentos.

Pré-requisitos

Para receber pagamentos reais, sua organização precisa ter uma conta de comerciante na Global Payments, por exemplo por intermédio do Desjardins, no Quebec. Seu gerente de conta fornecerá então duas credenciais próprias do seu aplicativo: um App ID e uma App Key.

Para testar o gateway de pagamento antes de assinar o contrato, crie gratuitamente uma conta no portal de desenvolvedores da Global Payments (developer.globalpayments.com). Um aplicativo de teste é criado nesse portal, com seu próprio App ID e sua própria App Key.

Configurar a Global Payments em uma conta de faturamento

Cada conta de faturamento tem seu próprio gateway de pagamento: você pode reservar a Global Payments para uma parte das suas atividades e deixar as outras em outra conta.

1. Acesse Administração›Configurações›Faturamento›Contas de faturamento, abra a conta de faturamento desejada e vá até a aba Pagamentos.
2. Ative Pagamentos online e selecione Global Payments na lista de gateways de pagamento.
3. Cole seu App ID e sua App Key. A App Key é salva de forma criptografada e nunca mais é exibida por completo.
4. Mantenha o campo Endereço da API em apis.globalpay.com. Escolha apis.eu.globalpay.com somente se a Global Payments tiver indicado isso a você.
5. Deixe o campo Nome da conta vazio: o OpenResa escolhe sozinho a conta a ser usada (veja abaixo).
6. Marque Ambiente de teste (sandbox) se você estiver informando as credenciais de um aplicativo de teste.
7. Clique em Salvar e depois em Testar a conexão.

Não é preciso cadastrar nenhum endereço de notificação no seu painel da Global Payments: o OpenResa envia ele mesmo seus endereços de retorno a cada pagamento. Um link Ajuda online no formulário retoma essas etapas.

Se o teste informar que as credenciais foram recusadas, verifique primeiro a caixa do ambiente de teste: credenciais de teste só funcionam com a caixa marcada, e credenciais de produção só funcionam com a caixa desmarcada.

Escolher a conta de processamento

Um aplicativo da Global Payments pode reunir várias contas de processamento de pagamentos. Quando o campo Nome da conta está vazio, o OpenResa usa 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 conexão mostra a conta escolhida, por exemplo Conexã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 indicada pela Global Payments no campo Nome da conta. Salve e depois execute o teste novamente.

Testar com o ambiente de teste

Com as credenciais de um aplicativo de teste e a caixa Ambiente de teste (sandbox) marcada, os pagamentos são fictícios: nenhum cartão é debitado, e os pedidos pagos geram faturas da série SPECIMEN, sem valor contábil.

Para fazer um pagamento de teste, pague um pedido com o cartão de teste Visa 4263970000005262, a data de validade 05/39 e o código de segurança 599: o pagamento é aceito. Outros cartões de teste estão descritos na documentação da Global Payments.

Para passar para produção, substitua o App ID e a App Key pelas suas credenciais de produção. Desmarque a caixa, salve e depois execute novamente o teste de conexão.

Entender o pagamento do lado do usuário

No momento de pagar, o usuário escolhe Pagamento online, apresentado com a indicação via Global Payments, e depois é redirecionado para a página de pagamento da Global Payments, em francês ou em inglês, conforme o idioma dele. Nessa página, ele informa os dados do cartão. Se o banco dele solicitar, ele confirma com a autenticação 3-D Secure.

Em seguida, ele volta ao OpenResa, que aguarda a confirmação da Global Payments: a mensagem Pagamento validado aparece geralmente cerca de dez segundos após o pagamento. O OpenResa envia então a ele, como para qualquer gateway de pagamento, a confirmação e a fatura.

Algumas regras próprias da Global Payments se aplicam:

• Endereço de e-mail. A Global Payments exige o endereço de e-mail do pagador. Portanto, o usuário precisa ter um endereço válido, com no máximo 50 caracteres, no pedido ou na conta dele. Caso contrário, o pagamento online é recusado com a mensagem É necessário um endereço de e-mail válido para pagar on-line. Verifique sua conta.
• Moeda. O pagamento é feito na moeda do pedido, por exemplo em dólares canadenses para um clube do Quebec. Essa moeda precisa estar ativada na sua conta da Global Payments: caso contrário, o usuário vê uma mensagem de indisponibilidade e você é alertado após várias falhas.
• Uma tentativa por página. Após uma recusa do cartão, o usuário volta ao OpenResa e tenta o pagamento novamente: uma nova página de pagamento é criada.

A página de pagamento da Global Payments permanece válida por 24 horas. Se o usuário a abandonar, o pedido continua pendente de pagamento, e ele pode pagá-lo novamente, pela Global Payments ou por outro meio de pagamento que você oferece.

Localizar um pagamento

No seu portal da Global Payments, cada pagamento tem uma referência que combina o número do pedido, sem os hífens, e o número da tentativa de pagamento: BJ2026000123T15349533 corresponde, por exemplo, ao pedido 2026-000123. Pesquise esse número de pedido em Administração›Painel de controle›Faturamento›Faturas & transações para abri-lo.

Nos detalhes do pedido, a transação indica as informações Identificador de transação da Global Payments, Número de autorização e Referência. A opção Registro de eventos da conta de faturamento lista os retornos recebidos da Global Payments e o resultado verificado, com o motivo de uma eventual falha. Em uma linha com falha, o botão Repetir consulta novamente o pagamento na Global Payments e o registra se ele tiver sido concluído.

Reembolsar um pagamento

O reembolso é feito a partir de Administração›Painel de controle›Faturamento›Faturas & transações: abra o pedido, clique em Reembolsar e escolha um reembolso total ou parcial. Com o bloco Global Payments, o OpenResa atualiza o pedido e envia o reembolso à Global Payments, que estorna o valor no cartão do pagador.

Um reembolso total retira os itens entregues (créditos devolvidos, assinatura revogada) e muda o status do pedido para reembolsado. Um reembolso parcial mantém o pedido como pago e apenas reduz o valor recebido. A Global Payments não aceita reembolsar mais do que o valor do pagamento.

Se a Global Payments não confirmar o reembolso, por exemplo em caso de queda de conexão, o pedido é atualizado mesmo assim e uma mensagem Reembolso a verificar em Global Payments pede que você verifique no seu portal se o reembolso foi realmente feito e que o faça, caso contrário.

Saiba mais