Masterpass
O Carat permite a integração do e-commerce do lojista com pagamentos que fazem autenticação através da carteira digital Masterpass. O comprador faz seu Carat sem inserir dados de seu cartão, utilizando apenas dados de usuário (e-mail ou celular) e senha. Para isso, o comprador precisa apenas abrir antes uma conta com a Masterpass e cadastrar suas informações de cartões de crédito e/ou débito.
É importante lembrar que o Masterpass não é um meio de pagamento, ou seja, não processa as transações. Trata-se de uma carteira digital que efetua a autenticação do comprador e fornece os dados para realização do pagamento para o comércio ou para os parceiros de processamento como o Carat.
Interfaces Carat suportadas para integração#
As seguintes interfaces do Carat podem ser utilizadas para a integração com Masterpass:
- Interface de Pagamento HTML 2.0 Saiba mais
- Interface Web Service de Cancelamento Saiba mais
- Cancelamentos via Portal do Lojista Saiba mais
Código de Autorizadora no Carat para Masterpass#
A cateira digital Masterpass é identificada pelo código (id) de autorizadora abaixo:
Configurações necessárias#
Antes de efetuar transações Masterpass com o Carat, devem ser seguidos os passos de configuração apresentados a seguir.
Criação do cadastro da loja no Portal Masterpass#
A loja deve entrar em contato com a Software Express e solicitar o seu cadastro na Masterpass para a equipe de Suporte Carat ou equipe Produção Carat que efetuarão este serviço.
Configurações necessárias no Carat#
Com a conta criada na Masterpass, os seguintes parâmetros de autorizadora devem ser cadastrados no Carat:
| Nome do campo no Carat | Descrição do campo | Obrigatório |
|---|---|---|
merchantCheckoutId | Identificador único de checkout obtido durante o processo de cadastro da loja na Masterpass. | SIM |
bandeirasPermitidas | Indica quais bandeiras serão apresentadas na carteira (wallet) do cliente no ambiente da Masterpass. Valores permitidos: - amex (American Express) - diners - discover - maestro - master (mastercard) - visa Os valores devem ser escritos como nos exemplos separados por vírgula (,). Exemplo permitindo master e visa: visa,master Exemplo permitindo visa, diner e discover: visa,diners,discover | SIM |
Estes parâmetros devem ser informados à equipe de cadastro do Carat.
Bandeiras permitidas#
De acordo com a documentação (versão 1 – com última atualização no dia: 01 de fevereiro de 2017), as bandeiras permitidas atualmente pela Masterpass são:
- Mastercard
- Visa
- American Express
- Discover
- Maestro
- Diners
Porém, mudanças podem ocorrer, e, por isso, para uma informação mais atualizada sugerimos fortemente que a loja entre em contato com a Masterpass e confirme essas informações.
Fluxo de Pagamento Masterpass#
O fluxo básico de pagamento utilizando a carteira digital Masterpass inicia-se conforme apresentado na integração de pagamentos HTML do Carat.
Na figura abaixo se apresenta o fluxo de um pagamento com autenticação Masterpass:
Aviso de Status#
Para cada alteração de status de transação no Carat, resultante de comunicação entre o Carat e a Masterpass, é enviado ao servidor da loja um Aviso de Status. Saiba mais
Propriedades para uma transação de pagamento com a carteira digital Masterpass#
As propriedades usadas para se criar uma transação de pagamento com a carteira digital Masterpass são os mesmos que os apresentados no Pagamento HTML, Pré-Autorização HTML e Recarga HTML.
Estorno de pagamentos Masterpass#
Os pagamentos feitos no Carat com a carteira digital Masterpass podem ser estornados utilizando a Cancelamento REST ou pelo Portal do Lojista.
Note que é necessário ter o número do cartão em mãos para que o estorno seja possível. Para isso, é preciso armazenar o cartão e efetuar o cancelamento utilizando o token/hash do cartão (Saiba mais) OU entrar em contato direto com o portador do cartão para obter o número.