You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

服务端确认Stripe PaymentIntent 实现免客户端操作自动支付

Stripe Connected场景下服务端自动扣款实现方案

你要实现的司机结束行程后无感自动扣款,完全可以在服务端完成全流程,不需要客户端做任何确认操作,核心是调整PaymentIntent的创建参数、启用离线无交互支付模式,具体实现步骤如下:

  • 去掉冗余的PaymentMethod预克隆流程
    你当前每次支付前手动克隆PaymentMethod到Connected Account的操作没有必要,Stripe支持在带Connected Account标识的请求中,直接使用平台侧存储的Customer ID和PaymentMethod ID发起支付,平台会自动完成跨账户的支付方式关联,能省一次API调用。
  • 创建PaymentIntent时开启自动确认+离线支付标记
    你当前拿到requires_confirmation状态的PaymentIntent,是因为创建时没有传自动确认参数,也没有标记这是用户离线场景的支付。只要在创建参数里加上对应配置,Stripe会在创建PaymentIntent的同时直接发起扣款,全程不需要客户端参与。
    修正后的代码示例:
    RequestOptions requestOptions = RequestOptions.builder()
        .setStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}") // 对应收款司机的Stripe Standard账户ID
        .build();
    
    PaymentIntentCreateParams params = PaymentIntentCreateParams.builder()
        .setAmount(100L) // 金额单位为最小货币单位(这里是美分),注意传Long类型避免精度丢失
        .setCurrency("usd")
        .setPaymentMethod("{{PLATFORM_STORED_PAYMENT_METHOD_ID}}") // 平台侧留存的乘客支付方式ID
        .setCustomer("{{PLATFORM_STORED_CUSTOMER_ID}}") // 平台侧留存的乘客Customer ID
        .setApplicationFeeAmount(10L) // 平台抽取的服务费金额
        .setConfirm(true) // 核心配置:创建PaymentIntent后直接触发确认扣款,无需额外调用确认接口
        .setOffSession(true) // 标记为用户无感知的离线场景支付,不需要用户在场交互
        .setReturnUrl("https://your-service-domain.com/payment/callback") // 仅极端风控场景触发3DS验证时使用,正常扣款流程不会跳转
        .setErrorOnRequiresAction(true) // 已完成授权的支付方式触发交互验证时直接抛出错误,方便后续逻辑处理
        .build();
    
    PaymentIntent paymentIntent = PaymentIntent.create(params, requestOptions);
    
  • 分支状态处理
    • 接口返回的PaymentIntent状态为succeeded时,说明扣款已经完成,直接更新订单状态为已支付即可,整个调用过程完全在服务端完成,和乘客端是否打开APP没有任何关系,司机端点击结束行程后触发这个接口调用就行。
    • 接口返回requires_action状态时,说明该卡触发了卡组织强制的3DS安全验证,这类风控要求无法跳过,占比极低(只要乘客首次绑卡时完成过一次授权验证,后续扣款基本不会触发)。遇到这种情况可以给乘客发推送,等乘客下次打开APP时引导完成验证,之后自动重试扣款即可。
    • 接口返回其他失败状态时,走常规的支付失败重试、引导乘客更换支付方式的逻辑即可。
  • 安全注意
    这个场景下完全不需要把PaymentIntent的client_secret返回给任何客户端,所有支付逻辑都在服务端闭环即可,避免密钥泄露带来的盗刷风险。

内容的提问来源于stack exchange,提问作者Gerardo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 17:42:14