← 返回小青柠 合规文档
小青柠 · 技术文档

泰隆银行 e账簿与聚合支付接入说明

文档类型:架构方案 v1.0(草案) 状态:待泰隆银行 API 文档补充真实接口
配套:《支付与资金监管及风控说明》 · 运营主体:苏州枫繁智造科技有限公司
本文为架构方案,用于内部研发排期、与泰隆银行技术对接对齐。文中所有接口路径、字段名、报文格式均为占位与建议,待泰隆提供正式 API 文档、商户号、e 账簿账号后替换并补全(见第十节「待补清单」)。
目录
  1. 背景与目标
  2. 总体架构
  3. 账户 / 子账户体系
  4. 关键业务流程(时序)
  5. 接口与指令清单(占位)
  6. 风控对接点
  7. 对账与差错处理
  8. 安全与回调
  9. 实施里程碑
  10. 待补清单(真实接口占位)

一、背景与目标

小青柠为需求撮合平台,需具备在线收款、资金监管(冻结)、清算放款、退款能力,且须满足泰隆银行的合规风控要求。方案采用:

目标:① 资金全程在银行体系内闭环;② 担保交易「冻结—清算—放款/退回」可审计;③ 风控规则(频繁/夜间/同人/限额/阻断)在银行与平台双层落地;④ 对账清晰、差错可追。

二、总体架构

┌──────────┐   聚合支付(微信/支付宝/云闪付)   ┌──────────────────┐
│  小青柠   │ ─────────────收单回调──────────▶ │   泰隆银行        │
│  APP/后端 │                                   │  · 聚合支付网关   │
│          │ ◀────清算/退款/清分指令(签名)───── │  · e 账簿系统     │
└──────────┘                                   │   主账簿+子账户   │
      │ 订单/资金状态同步                        └──────────────────┘
      ▼
┌─────────────────────────────────────────────┐
│  平台服务层(业务)                            │
│  orders · escrow · clearing · risk-engine     │
└─────────────────────────────────────────────┘

三、账户 / 子账户体系

账户类型用途映射
平台主账簿e 账簿主账总账泰隆分配的主账簿号 LEDGER_MAIN
待清算账户担保冻结子户收意向金/加价款并冻结子账户 SUB_ESCROW
圆梦方结算子户个人/企业子户接收放款按 user_id 一对一 SUB_SETTLE_{uid}
平台服务费子户平台子户收服务费SUB_FEE
退款过渡户平台子户原路退回SUB_REFUND
子账户命名与开通方式以泰隆 e 账簿实际能力为准(可能为主账簿下的「虚拟子户」或「电子登记簿」)。SUB_SETTLE_{uid} 建议在圆梦方首次接单/提现前完成开户绑定。

四、关键业务流程(时序)

4.1 支付意向金(冻结)

用户→平台: 确认下单(需求单/金额)
平台→泰隆支付: 聚合下单(渠道,金额,订单号,回调URL) [签名]
泰隆支付→用户: 拉起微信/支付宝/云闪付
用户→泰隆支付: 完成支付
泰隆支付→平台: 支付成功回调(流水号,金额,状态)
平台→平台DB: 标记 escrow 已冻结, 关联流水
平台→用户: 展示「已支付·资金由泰隆监管」

4.2 加价二次支付

圆梦方加价 → 平台重算应付 → 若 > 已冻结额,需求方补差额,走 4.1 同路径,金额并入同一 escrow 关联。

4.3 验收 / 裁定 → 清算放款

验收通过 / 法庭裁定 → 平台生成清算指令
平台→泰隆e账簿: 清分(SUB_ESCROW → 扣费→SUB_FEE, 余款→SUB_SETTLE_{uid}) [签名]
泰隆e账簿→平台: 清分结果(流水)
平台→平台DB: 订单=已放款, 圆梦方可提现

4.4 全额退回

裁定需求方胜/合规取消 → 平台发退款指令 → SUB_ESCROW → SUB_REFUND → 原路返回用户。

4.5 服务费释放

按周期(T+1 或月结)将 SUB_FEE 释放至平台公司账户与支付通道(代付指令)。

五、接口与指令清单(占位)

能力建议路径/动作关键字段(占位)备注
聚合下单POST /api/pay/aggregate/ordermerchantId, channel(wechat/alipay/unionpay), orderNo, amount(分), subject, notifyUrl, sign生成支付凭证
支付回调POST {notifyUrl}tradeNo, orderNo, paidAmount, status, time, sign验签后更新 escrow
e账簿清分POST /api/ledger/clearledgerNo, escrowSub, feeSub, settleSub, feeAmt, payAmt, bizNo, sign冻结→放款
退款POST /api/ledger/refundorigBizNo, refundAmt, refundSub, sign原路退回
代付/释放POST /api/ledger/payoutfeeSub, targetAcct, amt, period, sign服务费释放
子账户开户POST /api/ledger/subacct/openuid, realName, idNo, bindCard圆梦方结算户
流水查询GET /api/ledger/flowledgerNo, date, page对账用
以上路径与字段为建议占位,最终以泰隆银行正式 API 文档与联调环境为准。研发应以「适配器层」封装银行接口,避免业务代码直接耦合具体报文。

六、风控对接点

银行要求对「频繁/夜间/同类同人/限额/阻止交易」落地,建议在下列节点对接:

规则平台侧银行侧(预期)
频繁交易下单/支付频控、令牌桶、人工队列收单频控、交易监测
夜间交易非常规时段大额二次验证、延时清算时段风控策略
同类同人交易设备指纹+IP+实名+银行卡关联图谱同户/同设备识别
限额单笔/单日/单月阈值配置商户额度与单户额度
阻止交易黑名单、制裁名单、可疑模式拦截并报送风控引擎直接阻断

平台需向银行提供交易监测数据接口(或按银行格式上报),并在清算前做「指令—结论」一致性校验(防止错配资金)。

七、对账与差错处理

八、安全与回调

九、实施里程碑(建议)

阶段内容产出
M1 接入准备签约、开通 e 账簿与聚合支付、拿商户号/密钥/沙箱商户资料、沙箱账号
M2 适配器封装银行接口为内部 escrow/clearing 服务adapter 层 + 单元测
M3 资金流支付/冻结/清算/退款/释放端到端联调联调报告
M4 风控平台风控引擎 + 银行风控策略对齐风控规则集
M5 对账日终对账、差错队列对账脚本
M6 上线灰度 → 全量;合规文档挂网上线评审

十、待补清单(真实接口占位)

向泰隆银行索取并补全以下内容后,本说明方可转为「实施版」:
苏州枫繁智造科技有限公司
小青柠技术团队 · 本文档随联调进展持续更新