Documentação legada do Pagar.me v5
Carteira de Cartões
As Carteiras de Cartões trabalham junto com a Carteira de Clientes.
Enquanto a Carteira de Clientes é o conjunto de clientes que transacionam ou transacionaram na loja, as Carteiras de Cartões (Wallets) são o conjunto de cartões de cada Customer.
Na imagem abaixo, fica clara a relação entre Loja, Carteira de Clientes (Customer) e Carteiras de Cartões (Wallet).
Inclusão de cartões
Funcionalidades relacionadas a uma carteira de cartões
| Ação | Endpoint v5 |
|---|---|
| Incluir cartão | POST /v5/customers/{id}/cards |
| Obter cartão | GET /v5/customers/{id}/cards/{cardId} |
| Editar cartão | PUT /v5/customers/{id}/cards/{cardId} |
| Listar cartões | GET /v5/customers/{id}/cards |
| Excluir cartão | DELETE /v5/customers/{id}/cards/{cardId} |
Atenção!
Compra com um Clique
A wallet (carteira de cartões) possibilita a utilização do serviço de "Compra com um clique".
Sua carteira de clientes será alimentada automaticamente sempre que uma nova cobrança for gerada, seja de forma avulsa, através de pedidos ou assinaturas. Possibilitando assim, que em transações futuras você disponibilize ao seu cliente a compra com apenas um clique.
Tal funcionalidade pode aumentar o número de compras já que o cliente (customer) não precisa digitar novamente todos os dados do cartão.
Zero Dollar Auth
Ao criar um cartão na nossa API será feita uma validação do cartão através da funcionalidade de ZeroDollar. Essa validação é importante para verificar se um cartão está válido para realizar uma compra antes que o pedido seja feito e com isso melhorar as chances de aprovação.
Esse processo não realiza nenhuma transação no cartão do comprador e, por isso, seu limite não é impactado.
Isso significa que vamos verificar junto à bandeira e ao banco se esse cartão efetivamente existe, além de validar se esse cartão está ativo e pode transacionar. Em cenário positivo, responderemos com sucesso a criação de cartão.
A resposta sobre se o cartão é válido é de responsabilidade do próprio banco e não é possível obter informações especificas sobre o motivo da falha da validação, limite disponível para o cartão validado ou características do cartão ou do portador.
Funcionalidade disponível para clientes dos modelos Gateway e PSP
Pagar.me Gateway · Zero Dollar Auth
Saiba mais sobre cartões através de nossa API Reference.
Jornada: Cobrar um cliente
Etapa 7 de 22