文档

信用卡

本指南介绍如何保存、更新和管理信用卡。

概述

Chromium 有一个内置功能，允许记住在 Web 表单输入的信用卡信息。当用户提交包含信用卡信息的 Web 表单时，库将询问是否将其保存到信用卡存储中。

如果您选择保存，下次加载该表单时，库会建议自动填写信用卡信息。

Web Form Autofill Credit Card

在这种情况下，必须启用 Web 表单自动填充功能。

要访问和管理所有已保存的信用卡，请使用 CreditCards：

Java
Kotlin

var creditCards = profile.creditCards();

val creditCards = profile.creditCards()

保存信用卡

当用户提交包含信用卡信息（持卡人姓名、卡号、有效期、CVV/CVC）的表单时，库会通过 SaveCreditCardCallback 询问您是否希望保存该卡。在回调中，您将被提示保存或拒绝保存该卡。例如：

Java
Kotlin

browser.set(SaveCreditCardCallback.class, (params, tell) -> {
    var card = params.creditCard();
    var network = card.network();
    var cardholder = card.cardholder();
    var number = card.number();
    var expirationMonth = card.expirationMonth();
    int expirationYear = card.expirationYear();

    if (network == VISA) {
        tell.save();
    } else {
        tell.decline();
    }
});

browser.register(SaveCreditCardCallback { params, tell ->
    val card = params.creditCard()
    val network = card.network()
    val cardholder = card.cardholder()
    val number = card.number()
    val expirationMonth = card.expirationMonth()
    val expirationYear = card.expirationYear()
    if (network == CreditCardNetwork.VISA) {
        tell.save()
    } else {
        tell.decline()
    }
})

如果您选择 save()，Chromium 会将该信用卡添加到信用卡存储中。下次在表单中输入相同的信用卡信息时，不会再次触发回调。

如果您选择 decline()，Chromium 将不会把该信用卡添加到存储中。下次输入完全相同的信用卡信息时，会再次触发回调。

管理信用卡

信用卡存储中的每条记录都由一个单独的 CreditCard 对象表示。它包含持卡人姓名、卡号、有效期、CVV/CVC 等。

要读取所有记录，请使用：

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()
}

要从存储中删除任何记录，请使用：

Java
Kotlin

creditCards.remove(creditCard);

creditCards.remove(creditCard)

要清除整个信用卡储存，请使用：

Java
Kotlin

creditCards.clear();

creditCards.clear()