如何在Braintree中无需交易存储PayPal Vault支付方式 需Java SDK方案

核心逻辑 #

Braintree原生支持直接将有效支付凭证存入Vault，无需发起实际交易，通过Java SDK的PaymentMethod.create()接口即可实现。

前置准备 #

• 提前在Braintree控制面板开启PayPal Vault功能
• 客户端生成paymentNonce时必须指定vault: true参数，生成的专属vault凭证才能用于存储
• 需为每个注册用户生成绑定的Braintree客户ID，存储到你的业务系统与用户账号关联

代码实现 #

1. 初始化Braintree网关（全局初始化一次即可） #

BraintreeGateway braintreeGateway = new BraintreeGateway(
    Environment.SANDBOX, // 生产环境替换为Environment.PRODUCTION
    "你的商户ID",
    "你的公钥",
    "你的私钥"
);

2. 为新注册用户创建Braintree客户记录 #

CustomerRequest customerRequest = new CustomerRequest()
    .email("用户注册邮箱")
    .customerId("你业务系统的用户唯一ID"); // 也可不传，由Braintree自动生成客户ID，后续需存储返回的ID

Result<Customer> customerResult = braintreeGateway.customer().create(customerRequest);
if (customerResult.isSuccess()) {
    String braintreeCustomerId = customerResult.getTarget().getId();
    // 将braintreeCustomerId与你的业务用户绑定存储
}

3. 无交易存储支付方式到Vault #

拿到客户端返回的paymentNonce后，直接调用存储接口即可：

PaymentMethodRequest paymentMethodRequest = new PaymentMethodRequest()
    .customerId(braintreeCustomerId) // 对应用户的Braintree客户ID
    .paymentMethodNonce("客户端传的paymentNonce")
    .options()
        .verifyPayPalVault(true) // 开启PayPal凭证有效性校验，避免存入无效支付方式
        .done();

Result<PaymentMethod> paymentMethodResult = braintreeGateway.paymentMethod().create(paymentMethodRequest);
if (paymentMethodResult.isSuccess()) {
    PaymentMethod storedMethod = paymentMethodResult.getTarget();
    String paymentToken = storedMethod.getToken();
    // 将paymentToken与用户绑定存储，后续交易直接使用该token发起即可
} else {
    // 错误处理，可通过paymentMethodResult.getErrors()获取具体错误信息
}

注意事项 #

• 若用户需要新增/更换支付方式，复用上述存储逻辑传入新的nonce即可
• 存储成功后可以从返回的PaymentMethod对象中获取PayPal关联的邮箱、账单地址等信息，用于后续业务校验

内容的提问来源于stack exchange，提问作者Marcel Wernisch