GoCardless 银行直接扣款集成金蝶云星空解决方案
更新: 9/16/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| GoCardless 银行直接扣款平台 |  | 金蝶云星空 |
采用订阅制、会员制或周期性服务费模式的企业（SaaS 服务商、会员制教育机构、物业及连锁服务企业、跨境订阅电商等），越来越多使用 GoCardless 通过银行直接扣款（Bacs / SEPA / ACH / BECS 等方案）向客户周期性收款。GoCardless 负责授权（Mandate）、扣款（Payment）、订阅（Subscription）与代付（Payout）结算，而企业的应收、收款核销、合同与凭证仍在 金蝶云星空 中核算。
两套系统割裂带来典型痛点：
- 每月扣款、退款、代付到账后，财务需人工逐笔在金蝶补录收款单、红冲单并核销银行流水，月底对账工作量大、易错。
- 订阅客户的"销售合同/收款计划"与 GoCardless 实际扣款状态脱节，无法实时掌握哪些客户已续费、哪些扣款失败（Failed）。
- 多币种（GBP/EUR/USD 等）扣款与代付，需手工折算入账，汇率与手续费分摊难以追溯。
- 扣款失败、退款、争议等异常缺乏自动预警，容易导致收入确认滞后或坏账。
基于 成集云（iPaaS）数据集成平台，可将 GoCardless 的扣款全生命周期与金蝶云星空自动打通，实现"签约授权—扣款—代付—退款—对账"全链路自动化。
解决方案
基于成集云数据集成平台，构建 GoCardless 与金蝶云星空之间的可视化自动同步任务。通过 GoCardless REST API（Bearer Token +
GoCardless-Version版本头）拉取客户、授权、扣款、订阅、代付与退款数据，并结合 Events / Webhooks 实时捕获状态变更；由成集云完成字段映射、币种折算、手续费分摊与去重校验后，自动写入金蝶云星空的客户、销售合同、收款单、收款计划、银行流水与红冲单，并以定时任务 + 事件触发双通道保障数据实时一致。
业务流程
一、基础资料同步流程
1. 客户与银行授权同步流程
- GoCardless
customers+customer_bank_accounts+mandates同步至金蝶 客户 与 客户银行档案，授权状态（pending / active / cancelled）映射为客户"扣款授权"标识。
二、收款业务同步流程
1. 扣款单（Payments）同步收款流程
- 每笔
payments（状态 paid_out / confirmed）按metadata.internal_order_number关联金蝶销售订单/应收单，自动生成 收款单 并核销；失败（failed）状态标记"扣款失败"，触发预警。
2. 订阅（Subscriptions）同步销售合同与收款计划流程
subscriptions映射为金蝶 销售合同（周期、金额、币种），并生成周期性 收款计划；每期实际扣款回写计划执行状态，实现"订阅—收款"闭环。
3. 代付（Payouts）同步银行流水与核销流程
payouts+payout_items拉取代付明细，按手续费、币种折算后生成 银行流水，并与已入账收款单自动核销，完成资金到账追溯。
4. 退款（Refunds）同步红冲流程
refunds关联原扣款，自动生成 红冲单/退款单，回冲应收与收款，保持收入口径准确。
三、状态与事件同步流程
1. 支付状态事件同步流程
- 订阅
events（payment.confirmed / payment.paid_out / payment.failed / refund.completed 等）通过 Webhook 实时推送至成集云，触发金蝶对应单据状态更新与预警通知。
对接说明
一、基础资料同步（GoCardless → 金蝶）
| GoCardless 对象 | 金蝶云星空对象 | 关键字段 |
|---|---|---|
| customers | 客户 | id → 客户编码；company / given_name+family_name → 客户名称 |
| customer_bank_accounts | 客户银行档案 | account_holder_name / iban / sort_code → 银行账号 |
| mandates | 客户"扣款授权"标识 | scheme（bacs/sepa/ach）、status、next_possible_charge_date |
二、业务单据同步（GoCardless → 金蝶）
| GoCardless 对象 | 金蝶云星空对象 | 同步规则 |
|---|---|---|
| payments | 收款单 / 应收单 | amount（最小货币单位需÷100）、currency、reference、metadata.internal_order_number 关联订单；status=paid_out 视为到账 |
| subscriptions | 销售合同 / 收款计划 | amount、interval（周期）、start_date、status 映射合同生效/暂停/终止 |
| payouts / payout_items | 银行流水 | 按代付批次生成流水，手续费单独列示，与收款单核销 |
| refunds | 红冲单 / 退款单 | 关联原 payment，金额、币种、状态回冲 |
三、同步规则与过滤条件
- 币种处理：GoCardless 金额以最小货币单位返回（如 GBP 便士），成集云统一 ÷100 折算为金蝶本位币金额，并记录原币种与汇率来源。
- 去重与幂等：以 GoCardless
id（PM/SU/PO/RF 前缀）作为唯一键，重复推送不重复入账。 - 过滤条件：仅同步
status为终态（paid_out / confirmed / failed / completed）的单据；待提交（pending_submission）不提前入账，避免虚增收入。 - 频率：Events/Webhook 实时触发；补充以每 15 分钟定时拉取
payments/payouts兜底对账。 - 失败处理：payment.failed 自动标记"扣款失败"并推送预警，便于启动催收或暂停订阅。
业务价值
- 对账自动化：扣款、代付、退款与银行流水自动核销，月末对账从数人天降至分钟级，错误率趋近于零。
- 收入实时可见：订阅收款计划与实际扣款状态闭环，财务实时掌握续费/流失，收入确认不再滞后。
- 多币种可追溯：原币种、汇率、手续费全程留痕，跨境订阅核算合规清晰。
- 异常主动预警：扣款失败、退款、争议实时提醒，降低坏账与客诉风险。
- 业财一体：客户、合同、收款、流水、红冲在金蝶统一口径，支撑管理层实时经营分析。
接口文档
- GoCardless 开放 API 文档：https://developer.gocardless.com/api-reference （Base
https://api.gocardless.com/，Bearer Token +GoCardless-Version头；含 customers / customer_bank_accounts / mandates / payments / subscriptions / payouts / refunds / events 及 Webhooks） - 金蝶云星空开放 API 文档（OpenAPI / Web API：客户、销售合同、收款单、银行流水、红冲单等）