TrueLayer开放银行集成金蝶云星空解决方案
更新: 10/15/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| TrueLayer开放银行平台 |  | 金蝶云星空ERP |
以跨境贸易、海外SaaS订阅、平台电商及有欧洲/英国业务的出海企业为代表，企业普遍通过 TrueLayer 的开放银行能力获取银行账户实时余额与交易流水（Data API），并以 Pay by Bank（Payments API v3）收取客户付款、以 Payouts 向供应商/员工付款、以 Refund 处理退款。但银行侧数据与金蝶云星空财务系统割裂，带来典型问题：
- TrueLayer 拉取的银行账户、余额与交易流水停留在开放银行侧，无法自动进入金蝶形成银行日记账与对账依据；
- Pay by Bank 收款成功后，财务仍需手工在金蝶录入收款单并核销应收，滞后且易错；
- Payouts 付款指令与金蝶付款单脱节，银行流水与应付核销难以自动匹配；
- 跨币种交易（GBP/EUR 等）缺少自动折算与汇兑损益归集，资金看板不准确。
通过 成集云 iPaaS 数据集成平台，将 TrueLayer 与金蝶云星空打通，实现"银行账户主数据统一、交易流水自动入账、Pay by Bank 收款实时核销、Payouts 付款自动对账"的银企业财一体。
解决方案
基于成集云数据集成平台，构建 TrueLayer 与金蝶云星空之间的可视化自动同步任务：以 TrueLayer 为开放银行数据与收付款入口，金蝶为财务核算与资金中枢。成集云通过 TrueLayer OAuth 2.0（client_credentials 获取应用级 Data/Payments Token，授权码获取用户级 Token）与金蝶云星空 OpenAPI 双向编排，支持 Webhook 事件（支付状态变更、账户交易变动）实时触发与定时增量拉取，统一字段映射与币种折算，保障银企资金数据一致。
业务流程
一、基础资料同步流程
1. 银行账户同步流程
TrueLayer Data API 获取的授权账户与币种对齐金蝶银行账户与币别档案，使流水可正确入账。
2. 余额与资金看板流程
TrueLayer 账户实时余额映射到金蝶资金看板，形成多账户资金视图。
二、业务单据同步流程
1. 交易流水入账流程
TrueLayer 账户交易（transaction）实时/增量同步金蝶，生成银行日记账与收款单/付款单，支撑自动对账。
2. Pay by Bank 收款核销流程
金蝶应收触发 TrueLayer Payments 创建 Pay by Bank 收款，用户授权付款后回调，成集云自动生成收款单并核销应收。
3. Payouts 付款对账流程
金蝶付款单触发 TrueLayer Payouts 发起付汇，付款状态回调后自动回写银行流水并核销应付。
4. 退款与红字处理流程
TrueLayer Refund 退款事件同步金蝶，自动生成红字收款单，保持应收与资金一致。
对接说明
一、基础资料同步（TrueLayer → 金蝶）
| 数据对象 | TrueLayer | 金蝶云星空 | 方向 |
|---|---|---|---|
| 授权账户 | Data API accounts（account_holder、IBAN） | 银行账户、客户/供应商银行档案 | TrueLayer → 金蝶 |
| 币种 | accounts/balances 币种 | 币别 | TrueLayer → 金蝶 |
| 余额 | balances（current、available） | 银行账户余额、资金看板 | TrueLayer → 金蝶 |
二、业务单据同步（TrueLayer ↔ 金蝶）
| 业务单据 | TrueLayer | 金蝶云星空 | 方向 |
|---|---|---|---|
| 交易流水 | transactions（description、amount、merchant） | 银行日记账、收款单/付款单 | TrueLayer → 金蝶 |
| Pay by Bank 收款 | Payments v3（payment_id、status=settled） | 收款单、应收核销 | 金蝶 ↔ TrueLayer |
| Payouts 付款 | Payouts（beneficiary、status） | 付款单、银行流水、应付核销 | 金蝶 ↔ TrueLayer |
| 退款 | Refund（refund_id） | 红字收款单、退款单 | TrueLayer → 金蝶 |
三、同步规则与过滤条件
- 触发方式：TrueLayer Webhook（支付状态变更、账户交易变动）实时触发；Data API 交易采用每 30 分钟增量（按
timestamp）兜底拉取。 - 鉴权：
POST https://auth.truelayer.com/connect/token以client_credentials获取应用级 Token（Data/Payments 隔离）；用户级 Token 走授权码换取；Bearer Token 统一托管于成集云密钥库。 - 字段映射：TrueLayer
account_id作为金蝶银行账户关联主键；transaction_id作为流水幂等键；payment_id作为收款单关联主键。 - 去重与幂等：以
transaction_id/payment_id做幂等键，重复回调只更新不重复建单。 - 安全校验：TrueLayer Webhook 启用 HMAC-SHA256 签名校验，验证签名与重放攻击防护。
- 币种与汇率：多币种（GBP/EUR 等）按金蝶币别折算，结汇差额归集汇兑损益。
- 异常处理：流水/支付写入失败自动重试并告警；无法匹配客户或应收的流水进入待处理队列，由出纳补录。
业务价值
- 银企业财一体：TrueLayer 账户、余额、交易实时同步金蝶，银行日记账与对账不再手工录入。
- 收款实时核销：Pay by Bank 付款成功自动生成收款单并核销应收，资金回笼可见。
- 付款自动对账：Payouts 付汇状态自动回写，应付与银行流水一键核销。
- 资金看板准确：多账户余额实时归集，跨币种自动折算，资金视角统一。
- 合规与可追溯：开放银行标准授权链路，退款/红字自动处理，审计轨迹完整。
接口文档
- TrueLayer 开发者文档（Data API、Payments API v3、Payouts、Webhooks）：
https://docs.truelayer.com/ - 金蝶云星空 OpenAPI（银行账户、币别、收款单、付款单、银行日记账、应收/应付核销）：金蝶云星空开放平台