如何精简Stripe Connect账户关联开户流程步骤？

问题说明 #

使用Stripe Java库（Kotlin）开发Connect用户转账功能，创建Standard账户后通过AccountLink引导用户完成开户，但默认流程包含10步（邮箱注册、2FA验证、企业信息录入等），需精简为仅保留步骤1、2、3、5（不含地址和手机号）、7、10，降低用户操作摩擦。

核心优化思路 #

Stripe的开户流程步骤由预填信息的完整性和AccountLink的收集配置共同决定：

1. 预填所有已掌握的用户信息，让Stripe自动跳过对应填写步骤
2. 配置AccountLink仅收集缺失的必填项，而非全部流程字段

修改后的代码实现 #

1. 优化Account.create请求（预填更多信息） #

suspend fun stripeCreateNewAccount(
    email: String,
    localID: String,
    productDescription: String,
    onSuccess: suspend (Account?) -> Unit,
) {
    try {
        Stripe.apiKey = Constants.STRIPE_TOKEN_TEST
        val metadata: MutableMap<String, String> = HashMap()
        metadata["id"] = localID

        val createAccountParams = AccountCreateParams.Builder()
            .setType(AccountCreateParams.Type.STANDARD)
            .setEmail(email.lowercase().trim())
            .setMetadata(metadata)
            .setBusinessType(AccountCreateParams.BusinessType.INDIVIDUAL)
            // 仅保留一个BusinessProfile配置，移除重复项
            .setBusinessProfile(
                AccountCreateParams.BusinessProfile.builder()
                    .setUrl("${Constants.BASE_URL}/list/$localID")
                    .setProductDescription(productDescription)
                    .build()
            )
            // 个人账户无需设置Company，移除该配置避免触发企业信息录入步骤
            .setIndividual(
                AccountCreateParams.Individual.Builder()
                    .setFirstName("John")
                    .setLastName("Smith")
                    .setEmail(email.lowercase().trim())
                    // 预填出生日期（若已收集），跳过对应步骤
                    .setDob(
                        AccountCreateParams.Individual.Dob.builder()
                            .setDay(1)
                            .setMonth(1)
                            .setYear(1990)
                            .build()
                    )
                    .build()
            )
            // 若用户已同意Stripe服务条款，提前设置该字段跳过条款确认步骤
            .setTosAcceptance(
                AccountCreateParams.TosAcceptance.builder()
                    .setDate(System.currentTimeMillis() / 1000)
                    .setIp("用户的IP地址")
                    .build()
            )
            .build()
        onSuccess(Account.create(createAccountParams))
    } catch (e: Exception) {
        e.printStackTrace()
        onSuccess(null)
    }
}

2. 修改AccountLink.create请求（指定仅收集必填项） #

suspend fun stripeLinkExistingAccount(
    idAccountToLink: String,
    onCompleted: suspend (String?) -> Unit,
) {
    try {
        Stripe.apiKey = Constants.STRIPE_TOKEN_TEST
        val params = AccountLinkCreateParams
            .builder()
            .setAccount(idAccountToLink)
            .setRefreshUrl("${Constants.BASE_URL}/profile")
            .setReturnUrl("${Constants.BASE_URL}/profile")
            .setType(AccountLinkCreateParams.Type.ACCOUNT_ONBOARDING)
            // 关键配置：仅收集缺失的必填信息，而非全部流程字段
            .setCollect(AccountLinkCreateParams.Collect.REQUIRED)
            .build()
        AccountLink.create(params)?.let { accountLink ->
            onCompleted(accountLink.url) // 生成精简后的开户链接
        } ?: run {
            onCompleted(null)
        }
    } catch (e: Exception) {
        e.printStackTrace()
        onCompleted(null)
    }
}

关键修改点说明 #

• 移除Company配置：因为设置了BusinessType.INDIVIDUAL，企业信息录入步骤属于冗余内容，移除后流程会自动跳过该环节
• 预填用户已知信息：如姓名、邮箱、出生日期等，Stripe会自动跳过对应填写步骤
• 设置collect=REQUIRED：强制Stripe只展示用户尚未填写的必填项，而非默认的全量流程
• 提前同意服务条款：若用户已在你的平台同意条款，通过tosAcceptance字段预填，跳过流程中的条款确认步骤

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