Mercury 数字银行集成金蝶云星空解决方案

更新: 10/8/2026 字数: 0 字 时长: 0 分钟

业务背景

源系统	成集云	目标系统
Mercury		金蝶云星空

越来越多科技创业公司、出海企业与跨境团队把 Mercury 作为主营数字银行账户，用于全球收款、跨境付款、供应商付汇、团队虚拟卡与资金归集。但 Mercury 中的账户余额、交易流水、收付款与对账数据无法自动进入企业财务系统——财务团队仍需手工导出 CSV、逐笔录单到金蝶云星空，普遍存在三大痛点：

• 重复劳动：每日本外币流水手工整理、录单，工作量随交易笔数线性增长；
• 折算易错：多币种收付款需人工查汇率折算本位币，错漏难以发现；
• 核销困难：银行流水与应收/应付单据割裂，月底对账靠人盯，资金可视性差。

通过 成集云 iPaaS 数据集成平台，可将 Mercury 账户与金蝶云星空打通，实现账户/交易/付款数据的自动同步与"业—财—银"一体化。

解决方案

基于成集云数据集成平台，以 Mercury API（Bearer API Token 或 OAuth2，base https://api.mercury.com/api/v1）为数据源，拉取账户、交易与收款人数据，并结合 Webhook（transaction.created / transaction.updated / *.balance.updated 等事件，HMAC 验签）实现准实时推送；在成集云平台内完成币种映射、交易方向识别、对方账户（Recipient）归一、跨币种折算与凭证规则编排后，自动写入金蝶云星空对应的银行账户、收款单、付款单与凭证，形成"银行流水 → 业务单据 → 财务凭证"的自动闭环。

业务流程

一、基础资料同步流程

1. 账户与币种同步流程

2. 收款人（Recipient）同步流程

二、业务单据同步流程

1. 收款交易同步流程

2. 付款/付汇同步流程

3. 退款/红冲同步流程

对接说明

一、基础资料同步（Mercury → 金蝶云星空）

• 账户/币种：Mercury GET /api/v1/accounts 返回账户列表（含 accountNumber、kind、currentBalance、availableBalance 与币种），映射为金蝶"银行账户"与"币别"（金蝶无对应币别时自动创建）。
• 收款人：Mercury GET /api/v1/recipients 返回收款人 / 付款方，按名称 + 类型匹配金蝶"客户 / 供应商"档案；未匹配则自动建档。

二、业务单据同步（Mercury → 金蝶云星空）

• 收款交易：监听 Webhook transaction.created（或增量轮询 GET /api/v1/transactions，按 start/end 日期与游标分页），amount > 0 记为收款，生成金蝶"收款单"，并依据 counterpartyName 与 note 中的订单号关联应收单自动核销。
• 付款/付汇：amount < 0（账户出款、付汇）生成金蝶"付款单 / 银行流水"，关联应付单核销。
• 退款/撤销：状态为 failed/void 或方向相反的收款交易生成"红字收款单 / 退款单"。
• 多币种折算：依据交易发生日汇率将外币金额折算为本位币，折算差异计入汇兑损益。
• 余额看板：基于 *.balance.updated 事件与 GET /api/v1/account/{id} 实时刷新金蝶资金看板。

三、同步规则与过滤条件

• 仅同步指定 Mercury 账户（accountId 白名单）的交易，排除内部互转（mercuryCategory 属内部转账）。
• 以交易 id（Mercury 交易唯一标识）作为幂等键，防止重复入账。
• 交易状态需为 completed / sent 才生成正式单据；pending 状态仅记录待处理。
• 同步频率：Webhook 准实时触发 + 每 15 分钟增量兜底轮询。

业务价值

• 银行账户流水自动入金蝶，取消手工导 CSV 录单，财务对账人力下降约 70%。
• 跨币种交易自动折算与核销，规避汇率折算错误与遗漏。
• 银行流水 — 收款 / 付款单 — 凭证自动串联，业财一体、资金可视。
• 通过 Webhook 实时感知到账，加速应收确认与资金周转。

接口文档

• Mercury API：https://docs.mercury.com/reference（Bearer API Token / OAuth2，base https://api.mercury.com/api/v1）
• Webhook 事件：transaction.created / transaction.updated / *.balance.updated（HMAC 验签）
• 金蝶云星空 OpenAPI（开放接口）：银行账户 / 币别 / 收款单 / 付款单 / 凭证等