从客户授权,到支付通道启用
客户在 Stripe 完成授权或填写资料,管理员确认账户能力后同步配置、核对清理结果,再手动启用通道。客户无需向平台提供自己的密钥、证件或银行资料。
人员、位置和权限仅依据三份 Markdown。管理员负责后台操作,业务人员转发链接,客户只在 Stripe 操作。文档未给出权限标识,三份 Word 正文尚未提取。
授权成功 ≠ 可以收款/
配置保存 ≠ 清理完成/
同步完成 ≠ 通道启用
管理员客户系统状态同步完成
客户是否已有 Stripe 账户?
有账户 → 授权关联
链接失效且尚无账户 ID 时,管理员手动重发;只发送最新链接。
需要新账户 → 创建并入驻
链接已访问或失效时,管理员为同一账户手动生成新链接。
两条路径汇合 · 客户完成后通知业务人员
未就绪 / 查询失败 → 按原因处理,必要时补资料,再手动查状态。查询失败时旧快照保留,但须展示本次错误。
READY · 进入同步确认
实时查询或目标校验未通过 → 不写 key7 / key8,管理员核对账户状态与配置后再操作。
configSaved=true · 配置已保存
部分清理失败 → 配置不回滚;对仍禁用的单个配置手动重做全部既定动作,再核对结果。
清理核对完成 · 通道仍为禁用
节点详细说明在流程图下方,点击查看当前步骤。
页面效果图与操作接口
完整接口参数和响应保留在这里。点击上方流程节点时,只切换右侧效果图,不跳离流程图。
API-01~07 是文档约定的 bussiness 内部接口,dataprocess 对前端的新路由尚未确定。API-08~10 是已核对当前代码的后台接口;API-11~13 为公开回调 / 提示页。
Connect 代理公共约定(API-01~07)
后台前端 → dataprocess(登录、支付配置管理权限、可信 oid、操作密码非空)→ bussiness(密码与配置归属校验、调用 Stripe)。下游统一 POST JSON,沿用服务请求头 type: dataprocess 与服务 token,服务 token 不交给浏览器。
所有请求包含 oid(运营商 ID,由可信登录权限约束)和 pass(本次运营商操作密码,非空且不能全空白)。密码、完整链接不写日志或持久化存储。示例均为虚构数据,密码仅用占位文本。
下游响应 {code, msg, info}:code=1 成功,code=99 业务失败。前端代理的 HTTP 映射尚待实现,不能靠英文 msg 判断成功。超时 / 连接失败单独处理,先查询实际记录或配置结果,再决定是否重试创建或同步。
共享 View 字段说明
id 即后续请求的 onboardingId;另含 oid, sourcePayMethodlistId, method, environment, accountCountry, accountId, relationStatus, stripeStatus, cardPaymentsStatus, payoutsStatus, requirementsSummary, restrictionsSummary, lastSuccessfulCheckedAt, lastCheckError, feeRate, accountLinkExpiresAt。
method 为 OAUTH_EXISTING / CREATE_NEW,environment 为 TEST / LIVE,时间值为 Unix 毫秒。除文档明确的 CONNECTED、READY 外,不补造其他状态枚举;摘要字段的具体结构与可空约定需联调核验。完整响应示例未作真实接口验证。
这五个节点,要分开理解
CONNECTED已关联
已有账户 ID;不能据此判断可收款。
READY账户就绪
本次查询确认能力可用;同步时还会再查。
configSaved=true配置已保存
账户与费率已写入;清理仍可能失败。
核对本次结果清理完成
逐配置、逐动作查看结果,失败时人工处理。
人工操作通道已启用
管理员启用通道后,继续进行支付验证。
dataprocess 在哪里?
运营后台→dataprocess→bussiness→Stripe
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。
- 清理失败不回滚已保存配置,清理结果只在本次响应返回,不持久化。
- 手动清理每次只选一个仍禁用的配置,从头执行全部既定动作;启用后不允许手动清理。