一 概述

是在基于数字中台的架构上，开发高效、安全的支付平台。满足基于数字中台开发的其他业务平台在移动支付、线上支付、网上转账等支付相关的需求。

二 架构图

三 功能描述

1 支付接口

1.1 开通个人支付账户

当前支付中心是基于通联支付平台，由于通联支付的监管要求，消费、退款、转账业务需要交易双方都必须开通支付账户；付款方需要开通个人会员，收款方需要开通企业会员。

1.2 开通申请

为了保障支付交易的安全，每笔交易请求需要进行加密处理，密钥由开通申请得来。

1.3 支付

业务套件可以通过调用该支付接口，实现支付交易，包括移动支付、网上支付。当前支持的支付方式为：通商云的微信小程序、支付宝二维码、微信二维码；收银宝的网银转账。对于没有付款账户的账单，实际调用的是充值接口。

1.3.1 移动支付

当前仅支持：通商云的微信小程序和支付宝公众号。

1.3.1.1 微信支付

1.3.1.2 电子钱包支付

1.3.2 网上支付

当前仅支持：通商云的微信二维码、支付宝二维码、网银支付；收银宝的B2B网银支付。

1.3.2.1 微信、支付宝扫码支付

1.3.2.2 收银宝网银支付

1.3.2.3 通商云网银支付

1.4 退款

业务套件可以通过调用该退款接口，实现给指定账单进行退款。支持全额和部分。退款金额将原路返回。因网银转账是直接到收款方的银行账户，所以不支持退款。

1.4.1 通商云退款

1.4.2 电子钱包退款

2 通联支付

该模块是给使用基于通商云平台的支付能力的业务模块的用户使用。

2.1 平台

该模块是给私有云部署的园区或企业的管理员，和公有平台的管理员使用。

2.2.1 通商云接入配置

该功能是提供给私有云部署的园区，园区作为平台方需要自己和通商云签平台接入协议，获得相关的接口参数和平台商户数据，并保存到系统中。才能调用通商云的相关功能。接入服务需要配置以下参数。并且上传证书文件和密钥文件。
| 字段 | 名称 |
| :———— | :———— |
| appid | 应用ID |
| secret | 密码 |
| certPwd | 密钥文件密码 |
| pfxName | 证书文件名字 |
| certName | 密钥文件名字 |
| host | 通商云接口地址 |
| trustCode | 托管账户集 |
| balanceCode | 标准余额账户集 |
| bondCode | 标准保证金账户集 |
| spareCode | 准备金额度账户集 |
| tradeCode | 标准营销账户集 |

2.2.2 收银宝接入配置

该功能是提供给私有云部署的园区，园区作为平台方需要自己和收银宝签平台接入协议，获得相关的接口参数，并保存到系统中。才能调用收银宝的相关功能。接入服务需要配置以下参数。
| 字段 | 名称 |
| :———— | :———— |
| vspKey | 密钥 |
| vspHost | 收银宝接口地址 |

2.2.3 平台商户管理

平台商户是通商云平台提供给接入平台用于频繁接收手续费而设置的。因为每笔交易的手续费将会先支付到平台商户账户，每月由接入平台和通商云做结算，为了规避支付宝和微信对于交易频次的监控，通商云平台按城市提供给接入平台一批设置好的平台商户账户，如果系统用同一个平台商户账户多次交易失败，则作废当前平台商户账户并启用新的平台商户账户。该模块提供对平台商户账户的查询、删除、导入等功能。

2.2.4 手续费设置

通商云平台对于每一笔交易都会收取一定的手续费，如果是私有云部署，则由园区和通商云平台协商。该模块提供给园区用户统一设置当前园区所有启用通联支付的手续费。

2.2.5 手续费查询

由于通联支付的每一笔交易的手续费都会先支付到平台的通商云账户上，再有平台和通商云平台按月进行线下结算。所以该模块提供平台方按月查看交易记录和手续费汇总等，只显示交易成功的记录。

2.2 园区、企业

该模块是给园区或者园区企业使用。

2.2.1 开通通商云账户

如果用户需要使用带支付功能的业务套件，且是作为收款方，则必须开通通商云的企业会员；进行认证并绑定手机号。其中包括上传营业执照、证件照等信息。

2.2.2 开通收银宝账户

通商云和收银宝都支持网银支付。但是通商云的网银支付是资金会先到收款企业在通商云的企业会员账户，然后由收款企业申请提现到自己的对公银行账户，需要收提现手续费；而收银宝的网银支付则是资金会在T+1到账收款企业的对公银行账户。

2.2.3 提现

该模块提供开通了通商云企业会员的用户把通商云虚拟账户里的资金提现到绑定的对公银行账户中。

2.2.4 余额查询

该模块提供查询用户开通的通商云企业会员虚拟账户的资金。

2.2.5 交易查询

该模块提供使用通联支付的所有交易订单按月查询、分类查询、金额汇总、手续费汇总等功能。

3 电子钱包

该模块是给运营方的园区或者企业创建自己园区或企业的电子钱包。而园区的员工则可以使用该钱包在园区的商户进行消费，最终由园区和商户进行消费结算。如果创建的电子钱包没有绑定支付账户，则不可以对该钱包进行线上充值操作。

3.1 运营方

该模块是给运营方的园区或者企业使用。

3.1.1 钱包管理

该模块给运营方用来管理自己创建的电子钱包，可以创建多个。可以对钱包进行创建、绑定支付账户、注销等操作。如果创建的电子钱包没有绑定支付账户，则园区员工对该电子钱包不能进行线上充值操作。

3.1.2 用户管理

该模块给运营方用来管理开通钱包的商户和员工，包括申请审核、注销等操作。商户账户需要审核后开启，员工账号默认自动开启。

3.1.3 用户充值

该模块提供给运营方对员工的电子钱包进行批量或者单独充值。这是员工的电子钱包的资金主要入口。

3.1.4 交易查询

该模块提供运营方查看使用电子钱包的所有交易订单按月查询、分类查询、金额汇总等功能。

3.2 企业和个人

该模块是给园区的商户和园区员工使用。

3.2.1 开通钱包

该模块是给园区的商户使用，用于开通园区创建的钱包，方便园区员工使用该钱包在自己商铺进行消费。

3.2.2 充值

该模块是给园区的员工用于给运营方创建的电子钱包进行线上充值，运营方的电子钱包必须绑定了支付账户。为了预防资金风险，如果账户余额+充值金额超过500则不允许充值。

3.2.3 余额查询

该模块是给员工查询自己的电子钱包的余额。

3.2.4 交易查询

该模块是给商户查看和自己相关的使用电子钱包的所有交易订单按月查询、分类查询、金额汇总等功能。

四 对接接口文档

1、网关服务

业务对接确认部署：
第一步，确认使用的支付渠道：是通商云、还是银雁、还是其他，明确渠道后，才能知道开通和服务类型
第二步，确认使用方主体，是B2B转账（分公->公，还是公->中间商->再提现），还是个人用户电子钱包(分虚拟货币和真实货币)等
第三步，确认需要对接的支付方式：例如手机app原生、还是微信公众号、小程序、H5都要明确

测试环境地址：https://dev.k8s.flyrise.cn/pay-gateway-api/doc.html#/home

接口分类：

五 相关资料

1、通商云接口文档地址

https://cloud.allinpay.com/ts-cloud-dev-web/#/apiCenter/index?params=y&key=413

2、收银宝接口文档地址

https://aipboss.allinpay.com/know/devhelp/main.php?pid=13

3、通商云测试平台地址

http://116.228.64.55:6901/portal/index.html

4、通商云生产环境后台地址

https://vsp.allinpay.com/login