Stripe Java客户端库技术文档

1. 安装指南

环境要求

• Java 1.8 或更高版本

使用Gradle

在项目的构建文件中添加以下依赖项：

implementation "com.stripe:stripe-java:26.7.0"

使用Maven

在项目的POM文件中添加以下依赖项：

<dependency>
  <groupId>com.stripe</groupId>
  <artifactId>stripe-java</artifactId>
  <version>26.7.0</version>
</dependency>

手动安装

你需要手动安装以下JAR包：

• Stripe JAR
• Google Gson

使用ProGuard

如果你打算使用ProGuard，请确保排除Stripe客户端库。你可以在proguard.cfg文件中添加以下内容：

-keep class com.stripe.** { *; }

2. 项目使用说明

请查阅Java API文档获取最新文档信息。

观看视频演示了解如何使用该库。

你也可以参考在线Javadoc。

以下是使用Stripe Java客户端库的一个简单示例：

import java.util.HashMap;
import java.util.Map;

import com.stripe.StripeClient;
import com.stripe.exception.StripeException;
import com.stripe.model.Customer;
import com.stripe.net.RequestOptions;
import com.stripe.param.CustomerCreateParams;

public class StripeExample {

    public static void main(String[] args) {
        StripeClient client = new StripeClient("sk_test_...");
        CustomerCreateParams params =
            CustomerCreateParams
                .builder()
                .setDescription("示例描述")
                .setEmail("[e-mail]")
                .setPaymentMethod("pm_card_visa")  // 通过Stripe.js获取
                .build();

        try {
            Customer customer = client.customers().create(params);
            System.out.println(customer);
        } catch (StripeException e) {
            e.printStackTrace();
        }
    }
}

3. 项目API使用文档

所有请求方法都接受一个可选的RequestOptions对象。如果你想要设置一个幂等键、使用Stripe Connect或者在每次方法调用中传递密钥，可以使用这个对象。

RequestOptions requestOptions = RequestOptions.builder()
    .setApiKey("sk_test_...")
    .setIdempotencyKey("a1b2c3...")
    .setStripeAccount("acct_...")
    .build();

client.customers().list(requestOptions);

client.customers().retrieve("cus_123456789", requestOptions);

4. 项目安装方式

请参考上述“安装指南”部分获取项目安装方式。