ℹ️

Vá para a Referência da API para acessar os exemplos completos de requisição e resposta.

E-wallets são cofres (repositórios) de cartões e dados de pagamento destinados a consumidores do e-commerce e do mundo físico. As carteiras digitais permitem que um consumidor realize o cadastro de seus dados de pagamento, tornando o processo de compra mais conveniente e seguro.

⚠️

Atenção

Para utilizar carteiras no Gateway de Pagamento, o lojista deverá possuir as carteiras integradas em seu checkout.

Entre em contato com o provedor de sua preferência para maiores informações sobre como contratar o serviço.

ℹ️

Importante

• Aceitamos apenas cartões de crédito e débito via e-wallets;
• A loja deve consultar a carteira para identificar o meio de pagamento utilizado na transação;
• O Gateway de Pagamento é capaz de tokenizar cartões de crédito de e-wallets, podendo ser cartões criptografados ou descriptografados. É necessário que a loja tenha o serviço de tokenização contratado e que o parâmetro SaveCard seja informado igual a "true".

E-Wallets disponíveis

O Gateway de Pagamento possui suporte para as principais carteiras digitais disponíveis no mercado, listadas a seguir:

• Apple Pay
• Samsung Pay
• Google Pay
• PayPal

⚠️

Atenção

• Quando o nó Wallet é enviado na requisição, o nó CreditCard passa a ser opcional.

Integração da E-Wallet

A requisição de autorização com o meio de pagamento e-wallet pode acontecer de duas formas:

1. Autorização com cartão criptografado: a requisição contém o nó Wallet, o campo WalletKey (usado pela Cielo para descriptografar os dados das e-wallets) e tokens adicionais de acordo com cada e-wallet. Esse tipo de integração é indicado para estabelecimentos que não possuem certificação PCI DSS;
2. Autorização com cartão descriptografado: a requisição contém o nó Wallet e a própria loja descriptografa os dados do cartão e submete os dados de forma aberta na autorização. Esse tipo de integração é indicado para estabelecimentos com certificação PCI DSS.

Com a e-wallet já totalmente integrada, o seu fluxo transacional de pagamento será o seguinte:

Cartão criptografado

Veja abaixo a representação de um fluxo transacional padrão na integração de uma e-wallet com cartão criptografado:

Cartão descriptografado

A autorização com cartão descriptografado acontece quando a própria loja descriptografa o payload recebido da wallet e envia por conta própria para a API Gateway de Pagamento para processamento e autorização.