Stripe Connect v2.8.035 · 交互对接说明

从客户授权,到支付通道启用

客户在 Stripe 完成授权或填写资料,管理员确认账户能力后同步配置、核对清理结果,再手动启用通道。客户无需向平台提供自己的密钥、证件或银行资料。

人员、位置和权限仅依据三份 Markdown。管理员负责后台操作,业务人员转发链接,客户只在 Stripe 操作。文档未给出权限标识,三份 Word 正文尚未提取。

授权成功 ≠ 可以收款/ 配置保存 ≠ 清理完成/ 同步完成 ≠ 通道启用
点击流程:中间看效果图,右边展开对应接口详情

完整接入流程

按箭头,从上往下看
管理员客户系统状态同步完成
客户是否已有 Stripe 账户?

有账户 → 授权关联

链接失效且尚无账户 ID 时,管理员手动重发;只发送最新链接。

需要新账户 → 创建并入驻

链接已访问或失效时,管理员为同一账户手动生成新链接。

两条路径汇合 · 客户完成后通知业务人员

未就绪 / 查询失败 → 按原因处理,必要时补资料,再手动查状态。查询失败时旧快照保留,但须展示本次错误。
READY · 进入同步确认
实时查询或目标校验未通过 → 不写 key7 / key8,管理员核对账户状态与配置后再操作。
configSaved=true · 配置已保存
部分清理失败 → 配置不回滚;对仍禁用的单个配置手动重做全部既定动作,再核对结果。
清理核对完成 · 通道仍为禁用

节点详细说明在流程图下方,点击查看当前步骤。

这五个节点,要分开理解

CONNECTED

已关联

已有账户 ID;不能据此判断可收款。

READY

账户就绪

本次查询确认能力可用;同步时还会再查。

configSaved=true

配置已保存

账户与费率已写入;清理仍可能失败。

核对本次结果

清理完成

逐配置、逐动作查看结果,失败时人工处理。

人工操作

通道已启用

管理员启用通道后,继续进行支付验证。

dataprocess 在哪里?

运营后台dataprocessbussinessStripe

dataprocess 校验登录和权限,约束可信 oid,转发本次操作密码及业务参数。bussiness 负责 Stripe 调用、状态判断、配置保存与清理。

OAuth 回调单独走 Stripe → bussiness。客户资料由客户直接在 Stripe 页面填写。

四个配置字段怎么记?

secret_key2
平台密钥,决定 Stripe 测试 / 正式模式。
secret_key17
OAuth Client ID,连接已有账户时使用。
secret_key7
客户 Connected Account ID。
secret_key8
平台费率,0.01 表示 1%。
什么样的支付配置可以同步?
  • 同一运营商、未删除、保持禁用,且没有未结束订单。
  • payId 只支持 8、9、10、18、19;secret_key2 与来源完全一致。
  • secret_key7 为空,或已是本次准备同步的 Account ID。
  • 一次同步使用统一 feeRate,允许 0~1、最多六位小数;App 与 POS 可分批配置不同的账户。
链接失效、选错账户或选错国家,怎么办?
  • 已有账户:尚无 Account ID 时可手动生成新 OAuth 链接,旧的未进入回调处理的链接失效。旧回调正在处理时,本次生成立即业务失败,稍后手动重试。
  • 已有账户授权记录取得 Account ID 后不能再次生成链接,也不能覆盖为另一个账户;v35 不提供自动换绑。
  • 新账户:Account Link 可能访问一次就失效,未复制或过期时为同一 Account ID 手动生成;return / refresh 页面不自动生成链接。
  • 同来源、同国家重复创建返回最近创建的账户。已有 Account ID 后改国家,会保留旧记录并创建新账户;尚无 Account ID 时必须按原国家重试。
  • 来源密钥变更导致摘要不匹配时,旧记录拒绝回调、查询与同步,应使用新来源配置重新接入。
各通道清理什么?有什么限制?
  • payId 8:Stripe Customer + 存储卡;9、10:Stripe Customer;18、19:Stripe Customer + POS Location。
  • 每个目标配置均执行自身全部既定动作,逐动作返回 SUCCESS / FAILED。
  • 清理失败不回滚已保存配置,清理结果只在本次响应返回,不持久化。
  • 手动清理每次只选一个仍禁用的配置,从头执行全部既定动作;启用后不允许手动清理。