GlobalPayments

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

Neste documento será usada a nomenclatura "GlobalPaymentsWS" para referenciar o roteamento no Carat.

Assim, a loja pode configurar o Carat 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 Carat 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.

CampoDescriçãoFormato
terminalNúmero de terminal que será definido pela GlobalPaymentsWS.< 3 N
merchantCodeNúmero do estabelecimento definido pela GlobalPaymentsWS.< 15 N
secretKeyChave 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 Carat. 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:

 -no-filter

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 Carat 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 Carat 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 Carat, 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âmetroDescriçãoFormatoObrigatório
authorizer_authenticationEste campo deve ser enviado com valor true caso se deseje uma transação com autenticação.

Saiba mais.
< 5 ANSIM

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 Carat.

Opção / ResultadoNúmero do cartão de créditoVencimentoCVV
À Vista454881204940000412/20123
Parcelado476112000000014812/17111
Negado111111111111111711/20-