GlobalPayments WS

A loja tem a possibilidade de configurar o roteamento de transações feitas com cartão de crédito no e-SiTef por vários meios de pagamento, um desses meios é a GlobalPayments.

Neste documento será usada a nomenclatura "GlobalPaymentsWS" para referenciar o roteamento no e-SiTef.

Assim, a loja pode configurar o e-SiTef para que as transações feitas com cartões VISA, por exemplo, sejam roteadas pela GlobalPaymentsWS enquanto que as feitas com MASTERCARD sejam roteadas pela CIELO.

Interfaces e-SiTef suportadas para integração

É possível utilizar as seguintes interfaces para a integração com o roteamento GlobalPaymentsWS:

Pagamento REST
Pré-Autorização REST
Cancelamento REST
Pagamento HTML
Pré-Autorização HTML
Cancelamento via Portal do Lojista

Observação: Esta integração também aceita o envio de dados de autenticação 3DS (eci, xid e cavv). Saiba mais.

Autorizadoras permitidas

Para maiores informações sobre quais autorizadoras são permitidas pela GlobalPaymentsWS, por favor, entrar em contato com ela.

Credenciais necessárias

A loja deve obter com a GlobalPaymentsWS as credenciais listadas abaixo, e repassá-las à Software Express ou fazer o cadastro como explicado mais a frente neste mesmo documento.

Campo	Descrição	Formato
`terminal`	Número de terminal que será definido pela GlobalPaymentsWS.	< 3 N
`merchantCode`	Número do estabelecimento definido pela GlobalPaymentsWS.	< 15 N
`secretKey`	Chave secreta do lojista na GlobalPaymentsWS.	AN

Cadastro das informações pelo portal do lojista

O próprio lojista pode cadastrar as informações obtidas com a GlobalPaymentsWS no Portal do Lojista do e-SiTef. Nesse ambiente será possível alterar as configurações. Para essa finalidade, o lojista deve selecionar a autorizadora e entrar na tela de edição como no exemplo exibido abaixo:

Fluxos

Nesta seção serão apresentadas as particularidades do fluxo transacional GlobalPaymentsWS.

Pré-Autorização REST

Serviço de efetivação de pré-autorização

Apesar da interface do e-SiTef possibilitar o envio das parcelas na Captura, a GlobalPaymentsWS requer o envio dessa informação na chamada da Pré-Autorização. Saiba mais.

Serviço de captura de pré-autorização

Na operação de captura, o valor da transação deve ser igual ou menor do que valor da transação de Pré-Autorização.

A GlobalPaymentsWS requisita o envio das parcelas na chamada de Pré-Autorização. Por este motivo, o envio de algum valor para este campo não será considerado na interface de Captura.

A GlobalPaymentsWS assume que todo parcelamento será considerado como sendo SEM Juros. Por isto, o envio de algum valor para o campo installment_type não será considerado na interface de Captura.

Pagamento REST

Essa interface suporta o envio da flag de recorrência, de campos de autenticação externa, além do soft descriptor.

Confirmação tardia

O pagamento REST possui o campo postpone_confirmation, que indica se o pagamento será feito com confirmação automática ou manual, sendo que esta última opção é feita através do serviço de confirmação de pagamento. Porém, por questões da API GlobalPaymentsWS, ao chamar o serviço de efetivação de pagamento com confirmação tardia, na prática é chamada uma requisição de pré-autorização e o serviço de confirmação gera uma requisição de captura.

Serviço de consulta de cartão

Este serviço permite uma consulta para validar o cartão que será utilizado no pagamento, na API da GlobalPaymentsWS. Para seu correto funcionamento, é necessário que a função ZeroDollar esteja habilitada no cadastro da loja na GlobalPayments.

Pagamento HTML

Para pagamentos HTML, na criação da transação no e-SiTef o campo postpone_confirmation permite que a transação de pagamento se torne pendente ao final da interação do usuário com as telas de e-SiTef, e posteriormente esta pode ser confirmada ou desfeita pela Interface REST de Confirmação de Pagamentos HTML.

Neste caso também existe a particularidade de que, quando a transação é criada com o campo postpone_confirmation com valor true, na prática é feita uma requisição de pré-autorização à API GlobalPaymentsWS, e consequentemente, a confirmação feita pela interface REST gera uma requisição de captura.

Cancelamento

Só poderão ser canceladas as transações capturadas ou confirmadas no dia corrente (até as 23:59:59).

O lojista poderá cancelar uma transação via a interface de cancelamento REST ou pelo Portal do Lojista.

A GlobalPaymentsWS aceita cancelamentos parciais apenas de transações de Pré-Autorização. Para as demais transações o cancelamento deve ser feito para o mesmo valor.

Autenticação via HTML

Caso esteja sendo utilizada a interface de Pagamento/Pré Autorização HTML, para realizar a autenticação o seguinte campo deve ser enviado na requisição:

Parâmetro	Descrição	Formato	Obrigatório
`authorizer_authentication`	Este campo deve ser enviado com valor `true` caso se deseje uma transação com autenticação. Saiba mais.	< 5 AN	SIM

Cartões de testes GlobalPaymentsWS

A GlobalPaymentsWS disponibiliza os seguintes números de cartões para o ambiente de testes, que podem ser utilizados no ambiente de Certificação / Homologação do e-SiTef.

Opção / Resultado	Número do cartão de crédito	Vencimento	CVV
À Vista	4548812049400004	12/20	123
Parcelado	4761120000000148	12/17	111
Negado	1111111111111117	11/20	-