List icon Conteúdo

Cartões de crédito

Este guia descreve como salvar, atualizar e gerenciar cartões de crédito.

Visão geral

O Chromium tem uma funcionalidade incorporada que permite lembrar os cartões de crédito introduzidos em formulários Web. Quando o usuário submete um formulário Web que contém informações sobre um cartão de crédito, a biblioteca lhe pergunta se o quer salvar na loja de cartões de crédito.

Se o salvar, da próxima vez que carregar o formulário, a biblioteca irá sugerir o seu preenchimento automático.

Formulário Web de preenchimento automático de cartão de crédito

A funcionalidade preenchimento automático de formulário Web deve ser ativada neste caso.

Para acessar e gerenciar todos os cartões de crédito salvos, utilize CreditCards:

Java
Kotlin
var creditCards = profile.creditCards();
val creditCards = profile.creditCards()

Salvando cartões de crédito

Quando o usuário submete um formulário com informação de cartão de crédito (nome do titular do cartão, número, data de expiração, CVV/CVC), a biblioteca lhe pergunta se quer salvar o cartão através de SaveCreditCardCallback. Na chamada de retorno, será pedido para salvar ou negar para gravar este cartão. Por exemplo:

Java
Kotlin
browser.set(SaveCreditCardCallback.class, (params, tell) -> tell.save());
browser.register(SaveCreditCardCallback { params, tell ->
    tell.save()
})

Se optar por salvar, este cartão será adicionado à loja de cartões de crédito. Da próxima vez que introduzir o mesmo cartão de crédito num formulário, a chamada de retorno não será invocada.

Se optar por recusar salvar o cartão, este não será adicionado à loja e, da próxima vez que introduzir exatamente o mesmo cartão de crédito, a chamada de retorno será novamente invocada.

Gerenciando os cartões de crédito

Cada registo na loja de cartões de crédito é representado por um objeto separado de CreditCard. Ele contém o nome do titular do cartão, o número, a data de expiração, o CVV/CVC, etc.

Para ler todos os registos, utilize:

Java
Kotlin
creditCards.all().forEach(creditCard -> {
    var number = creditCard.number();
    var network = creditCard.network();
});
creditCards.all().forEach { creditCard ->
    val number = creditCard.number()
    val network = creditCard.network()
}

Para remover qualquer registo da loja, utilize:

Java
Kotlin
creditCards.remove(creditCard);
creditCards.remove(creditCard)

Para limpar toda a utilização da loja de cartões de crédito:

Java
Kotlin
creditCards.clear();
creditCards.clear()