Build 收单技术架构

Build 收单技术架构

按参考图的「职责域分层」画法:接入端 → 开放网关 → 业务组开发域(对客产品)→ 平台组开发域(应用编排 + 风控)→ 平台组服务域(收单公共能力)→ 外部 Provider & Network;架构组负责纵向公共服务。

接入端 商户 / 付款人 / 运营
商户服务端Server-to-Server
Web / H5 收银台付款人浏览器
App SDKiOS / Android
POS / 二维码线下受理
Merchant Portal商户自助
Build Admin运营管理后台
HTTPS · 签名 · 幂等键
acq-openapi-gateway 收单开放网关鉴权验签 · 幂等 · 限流 · 版本路由 · 统一对外错误码
业务组开发域 对客产品形态(产品形态 ≠ 支付方式)
P0acq-payapi-svcPayment API / SDK服务端创建/查询/退款;SDK 安全采集
P1acq-checkout-svcUniversal Checkout托管/嵌入收银台,按地区币种展示支付方式DB
P0acq-paylink-svcPayment Link白标链接、有效期;Request→Link→TxnDB
P2acq-inperson-svcIn-Person / QR设备、终端、线下状态确认DB
P1acq-portal-svc商户门户交易/结算/对账查询与自助配置
P1acq-bizadmin-svc收单运营后台商户、Provider、配置中心、审批
业务线(共享底座,规则隔离):BanoBoltBeem…
平台组开发域 收单应用层
业务模式规则ISOPayFacAcquirer配置 + 责任边界,不是三套系统
P0acq-application-core收单应用层支付会话、交易编排(校验→风控→路由→渠道→状态校准)、模式差异规则、产品能力组合DB
风控合规
P0acq-riskcore-svc风控合规核心制裁地区校验、KYB/准入、交易风控、3DS 策略、审计DB
平台组服务域 收单公共能力(交易 / 资金 / 账务分开建模)

主体与商户

P0acq-entity-srv主体账户域Legal Entity / Account / 资金归属DB
P0acq-merchant-srv商户域Merchant / Sub-merchant、入驻、生命周期DB

交易处理

P0acq-payment-srv交易域统一交易 ID、状态机、幂等、退款DB
P1acq-case-srv争议与工单域拒付、异常、人工任务 CaseDB

Provider 编排

P2acq-provider-srvProvider 管理域外部 MID 映射、能力矩阵、运行状态DB
P2acq-routing-srv路由域按能力/地区/币种/成本/健康度选路DB
P0acq-channel-gateway渠道适配网关协议/签名适配、状态与错误码映射、回调接收、超时查询补偿(每个 Provider 一个 Adapter)

资金与账务

P1acq-fee-srv计费域商户定价、Provider 成本、FXDB
P1acq-commission-srv分佣域分润、Rebate、应付DB
P0acq-ledger-srv账务域记账分录、余额、可追溯DB
P1acq-settle-srv结算出款域结算批次、应结、PayoutDB
P1acq-recon-srv对账域报表拉取适配(如 CYBS Report)、差异分类DB
Adapter 调用 · 异步回调 · 报表文件
Provider & Network 外部能力供给方(不进入内部数据模型)
CybersourceCard · 3DS · Report API
Mesh PayWallet · 托管页
钱包 ProviderWallet
银行 / 企业网银Bank · Bano Request
BNPL / 本地支付Local Payment
Sponsor Acquirer / 卡组织PayFac · Acquirer 模式
服务名为示意命名(沿用参考图 finance-* 的风格改为 acq-*),落地时按实际仓库替换;阶段标签依据项目文档「十一、演进路线」。 关键约束:Provider MID 不作内部商户 ID;交易、结算、账务、出款状态分开;超时 ≠ 失败;外部报表经适配层转为内部模型。