0. 联调总体说明

1. 电子协议

1.1 接入流程

1.2 进件前签约

（建议使用本模式）

调用3.5电子协议相关接口，完成电子协议签署，获得电子协议号；

调用“3,1,1图片上传”接口，将图片上送给易生，易生返回图片唯一ID；

调用“3.1.2商户信息录入”接口，将商户信息及图片唯一ID、协议号上送给易生，易生返回商户唯一标识；

如在第3步上送了通知地址，易生会异步将审核结果通知到该地址；如未上送，可调用“3.1.6申请单状态查询”接口，使用申请单编号查询审核状态。

1.3 进件后签约（目前2.0暂不支持）

调用“3.1.1图片上传”接口，将图片上送给易生，易生返回图片唯一ID；

调用“3.1.2商户信息录入”接口，将商户信息及图片唯一ID上送给易生，易生返回商户唯一标识；

如在第2步上送了通知地址，易生会异步将审核结果通知到该地址；如未上送，可调用“3.1.6申请单状态查询”接口，使用申请单编号查询审核状态

调用3.5电子协议相关接口，完成电子协议签署，获得电子协议号；

调用“3.1.3商户信息变更”接口，将电子协议号送给易生。

2. 订单分账

基于原支付订单，提供逐笔订单分账功能。

主单清算标识是否分账（splitSettleFlag）送1，通过接口中分账信息字段（separateInfo）上送分账子单明细。

支持支付请求中同步上送分账信息、支付后异步上送分账信息两种模式。

分账资金到账周期、到账方式，需提前为商户或分账接收方开通和配置，分账受理成功后按配置到账。

交易后分账场景下，交易后30日内，在剩余可分账金额大于0的情况下，可多次发起分账，最多40次。

手续费承担：
6.1 支持按订单上送手续费承担明细（sepaFeeAmount、sepaFeeRatio）；
6.2 支持各方按分账金额占订单金额的比例各自承担手续费、其中一方全额承担手续费。

2.1 交易中分账

调用“3.1.2商户信息录入”或“3.1.3商户信息变更”接口，为新增商户或存量商户开通分账业务；

调用3.2.1-3.2.3相关接口，完成分账接收方信息录入；

调用3.2.4-3.2.5相关接口，完成分账接收方与商户的分账关系绑定；

调用“4.条码类交易接口”，接口中同时上送分账子单明细，发起支付申请；

等待易生按照商户、分账接收方预先配置的结算周期和方式完成结算。

2.2 交易后分账

调用“3.1.2商户信息录入”或“3.1.3商户信息变更”接口，为新增商户或存量商户开通分账业务；

调用3.2.1-3.2.3相关接口，完成分账接收方信息录入；

调用3.2.4-3.2.5相关接口，完成分账接收方与商户的分账关系绑定；

调用“4.条码类交易接口”，发起支付申请，交易中暂不上送分账子单明细；

针对已成功的支付交易，在交易后30天内，调用“5.1分账请求”接口，上送分账子单明细，发起分账请求；

等待易生按照商户、分账接收方预先配置的结算周期和方式完成结算。

3. 营销

3.1 toB指令营销

定义：由出资方出资补贴给商户的营销活动，例如手续费减免、订单补贴。
开通流程：

商户、出资方：明确营销活动规则，包括活动时间、预算金额等。

出资方与易生签署营销活动协议。

开通营销出资方客户号：联系客户经理（需要有协议）

线下银行转账至易生ACS账户：联系客户经理确认转账备注说明，转账成功后会自动上账到出资方客户号的现金户

完成营销活动配置，获得营销活动ID：联系客户经理，活动创建成功后，会将活动预算金额从现金户中扣除，转入营销账户。

在marketingOrders中上送营销活动ID、营销金额信息。

易生按商户结算周期，将营销资金划付给商户。

易生不对营销资金开票。

3.2 toC指令营销

定义：出资方出资补贴给C端付款用户的营销活动，实付金额减少，优惠金额一并结算给商户
业务流程

商户、出资方：明确营销活动规则，包括活动时间、预算金额等。

出资方与易生签署营销活动协议。

开通营销出资方客户号：联系客户经理（需要有协议）

线下银行转账至易生ACS账户：联系客户经理确认转账备注说明，转账成功后会自动上账到出资方客户号的现金户

完成营销活动配置，获得营销活动ID：联系客户经理，活动创建成功后，会将活动预算金额从现金户中扣除，转入营销账户。

在marketingOrders中上送营销活动ID、营销金额信息。

易生按商户结算周期，将营销资金划付给商户。

易生不对营销资金开票。

4. 极速退款

4.1 适用场景

定义：实时原路退回给付款方，支持全额退或部分退，适用于客户预存退款资金至虚拟账户中，退款资金从余额中实时扣除的场景。例如：

商户要求结算与退款收支两条线：不从待结算金额中扣除退款资金。

分账后退款：因交易资金已分账结算给分账接收方，退款的资金需要商户预存至我司，并线下与分账接收方完成资金往来处理。通过本接口发起退款，退款资金从商户预存账户余额中扣除。

4.2 开通流程

请联系客户经理。

5. 终端管理

5.1 机具入库说明

业务场景：

使用易生机具+不通过接口进件

使用易生机具+通过接口进件

携机入网+不入库+通过接口进件

携机入网+入库+通过接口进件

5.2 首次新增终端

定义：指商户在开通相关业务后（比如银行卡业务），第一次新增终端，包括开通业务时同步新增终端、先开业务后新增终端两种场景。
银行卡业务开通流程.jpg

5.3 增机

定义：对已装机的商户新增终端，包括在存量门店下新增终端、新门店下新增终端。

5.4 换机

定义：因机器故障等原因，对已装机的终端更换机具。系统会自动同步解绑老机具和绑定新机具。
换机.jpg

5.5 撤机

定义：因业务需要，对已装机的终端撤销机具，撤销后机具自动解绑，且终端号失效。

6 微信分

6.1 名词解释

微信分服务单 ：微信分场景下，处理支付前的一系列服务流程的订单，包括创建、取消、查询、完结、登记扣款等。

微信分交易单：微信分场景下，处理实际支付的订单，主动支付时为jsapi下单，后台代扣场景下为委托扣款交易。

需确认模式：按订单单次授权。用户授权成功后，商户仅能针对当前订单调用一次支付分的订单创建和完结。

免确认模式：按商户维度授权，是长期授权。用户授权成功后，商户可以通过后台接口进行支付分的订单创建和完结，无需用户再授权确认。

6.2 场景举例

共享充电宝、单车：需确认订单模式

网约车：免确认模式

6.3 产品介绍

参考微信官方介绍文档：https://pay.weixin.qq.com/doc/v3/partner/4012625479

6.4 联调说明

（1）. 联调前准备

商户开通微信分：商户在易生入网——获得微信子商户号——线下流程提交子商户号及材料至微信（运营流程）——微信审核——线下通知审核结果——成功的商户收到微信签约信息——签约后开通成功。

务必确认申请的重要参数：去微信申请开通时，需要提前确认好使用微信分业务的商户APPID、渠道号channel_Id（对应服务商认证码）、微信子商户号，申请通过后，交易中使用的此类参数必须同申请开通，否则会交易失败。如需更换，需要重新走流程去微信申请，微信审批时间不好预估。

常见关联报错

"mchid与sub_mchid、sub_appid之间Mma绑定关系不存在"

解决办法一：客户经理在商管平台将商户的sub_appid加白配置给该商户；
解决办法二：客户经理将该商户拆分在该sub_appid下。

（2）. 联调及上线

已开通商户微信分支付功能的商户，可进入联调流程。其中商户调起微信分授权相关接口，由客户直接对接微信（接口文档地址见11.1.0）。

与易生完成联调后，需要商户提交上线材料（含完整业务场景流程录屏），完成审核后，线下通知商户正式投产。

6.5 业务流程

微信分服务单状态说明：
CREATED:商户已创建服务订单
DOING:服务订单进行中
DONE:服务订单完成(终态)
REVOKED:商户取消服务订单(终态)
EXPIRED:服务订单已失效，"商户已创建服务订单"状态超过30天未变动，则订单失效(终态)

6.5.1 创建微信分服务单

以下为需确认模式：

6.5.2 用户主动支付

6.5.3 后台代扣

7 云微笔笔支付

7.1 定义

7.2 适用场景

7.3 业务流程

7.4 联调说明

（1）. 联调前准备：

客户经理与运营部确认分公司是否已有银联全渠道机构号，如否，需要协同运营部去银联申请

客户经理协同运营部去银联（银联分公司），为商户申请开通云微笔笔支付（对应银联产品包0418），获得银联商户号。

（2）. 联调说明：

需要使用在生产环境获得的银联商户号，在联调环境做测试，联调前提供给联调技术支持人员做配置，以获得联调参数。

由于涉及商户客户端调起云闪付微信小程序，此流程仅支持生产环境做验证，建议商户在联调环境完成下单（4.1.4云闪付APP支付）的联调，能正常获得响应后，使用生产环境客户端调起微信分做验证。

1.3 业务接入指引

0. 联调总体说明#

1. 电子协议#

1.1 接入流程#

1.2 进件前签约#

1.3 进件后签约（目前2.0暂不支持）#

2. 订单分账#

2.1 交易中分账#

2.2 交易后分账#

3. 营销#

3.1 toB指令营销#

3.2 toC指令营销#

4. 极速退款#

4.1 适用场景#

4.2 开通流程#

5. 终端管理#

5.1 机具入库说明#

5.2 首次新增终端#

5.3 增机#

5.4 换机#

5.5 撤机#

6 微信分#

6.1 名词解释#

6.2 场景举例#

6.3 产品介绍#

6.4 联调说明#

6.5 业务流程#

6.5.1 创建微信分服务单#

6.5.2 用户主动支付#

6.5.3 后台代扣#

7 云微笔笔支付#

7.1 定义#

7.2 适用场景#

7.3 业务流程#

7.4 联调说明#