E-wallets

ℹ️
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.

Meios de pagamento aceitos via e-wallets: cartões de crédito e débito.

E-wallets disponíveis

O Gateway de Pagamento oferece suporte às principais carteiras digitais do mercado:

Para identificar o meio de pagamento usado na transação, é necessário consultar a carteira.

Pré-requisitos

Para usar e-wallets como meio de pagamento no Gateway de Pagamento, é necessário:

Usar a Cielo como adquirente (provedor "Cielo30");
Contratar a carteira digital desejada;
Integrar a carteira digital ao Gateway de Pagamento, seguindo o fluxo de cartão criptografado ou descriptografado.

Para saber como contratar o serviço, entre em contato diretamente com o provedor da carteira digital escolhida.

Tokenização de cartões via e-wallets

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

Integração da E-wallet

A requisição de autorização com o meio de pagamento e-wallet pode ocorrer de duas formas: com o cartão criptografado ou com o cartão descriptografado.

Cartão criptografado

Na autorização com cartão criptografado, a loja não tem acesso aos dados do cartão. Essas informações são enviadas em forma de token, e o Gateway de Pagamento realiza a descriptografia e dá sequência ao processo de autorização da transação.

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.

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

Na autorização com cartão descriptografado, a própria loja descriptografa o payload recebido da e-wallet e envia os dados do cartão diretamente para a API do Gateway de Pagamento, para o processamento e a autorização da transação.

A requisição contém o nó Wallet, e a própria loja é responsável por descriptografar os dados do cartão e enviá-los de forma aberta no momento da autorização.
Esse tipo de integração é indicado para estabelecimentos com certificação PCI DSS.

Com a e-wallet totalmente integrada, o fluxo transacional de pagamento ocorre da seguinte forma: