易企通2.0
  1. 1.总体介绍
易企通2.0
  • 1.总体介绍
    • 1.1 阅读人员
    • 1.2 名词解释
    • 1.3 业务接入指引
    • 1.4 版本说明
    • 1.5 接口调试工具说明
  • 2.接口规范
    • 2.1 接口格式定义
    • 2.2 加签验签说明
    • 2.3 参数说明
  • 3.商户进件类接口
    • 3.1 收单商户信息
      • 3.1.1 图片上传接口
      • 3.1.2 商户信息录入
      • 3.1.3 商户信息变更
      • 3.1.4 申请单状态查询
      • 3.1.5 商户详情信息查询
      • 3.1.6 商户审核异步通知
      • 3.1.7 商户注销申请
    • 3.2 非收单会员信息
      • 3.2.1 非收单会员信息录入
      • 3.2.2 非收单会员信息查询
      • 3.2.3 非收单会员信息变更
      • 3.2.4 分账关系绑定
      • 3.2.5 分账关系解绑
      • 3.2.6 查询分账关系
    • 3.3 终端管理
      • 3.3.1 机具入库
      • 3.3.2 终端机具参数查询
      • 3.3.3 物料查询
      • 3.3.4 查询授权码
      • 3.3.5 重置授权码
      • 3.3.6 商户终端状态管理
      • 3.3.7 终端绑定/解绑申请
      • 3.3.8 终端换机申请
      • 3.3.9 辅助终端设备信息校验
    • 3.4 微信支付宝配置类
      • 3.4.1 微信支付宝商户入驻
      • 3.4.2 微信支付宝认证申请
      • 3.4.3 微信支付宝认证申请状态查询
      • 3.4.4 微信支付宝认证申请结果查询
      • 3.4.5 微信支付宝子商户信息查询
      • 3.4.6 微信商户新增APPID
      • 3.4.7 微信商户新增支付授权目录
      • 3.4.8 微信商户开发配置查询
      • 3.4.9 微信支付宝商户信息修改
    • 3.5 电子协议
      • 3.5.1 企业开户
      • 3.5.2 个人开户
      • 3.5.3 创建合同
      • 3.5.4 发送验证码
      • 3.5.5 签署合同
      • 3.5.6 查询合同
      • 3.5.7 下载合同
      • 3.5.8 增加印章
      • 3.5.9 查询印章
      • 3.5.10 修改印章
      • 3.5.11 删除印章
    • 3.6 商户交易限额管理
      • 3.6.1 新增限额
      • 3.6.2 查询限额
      • 3.6.3 修改限额
    • 3.7 渠道报备查询
      • 3.7.1 商户报备查询
      • 3.7.2 终端报备查询
  • 4.条码类交易接口
    • 4.1 支付
      • 4.1.1 付款码支付
      • 4.1.2 JSAPI支付
      • 4.1.3 主扫支付
      • 4.1.4 云闪付APP支付
      • 4.1.5 交易查询
      • 4.1.6 交易查询(返费率)
      • 4.1.7 交易关闭
      • 4.1.8 交易结果通知
      • 4.1.9 银联无感支付签约
      • 4.1.10 银联无感支付解约
    • 4.2 退款
      • 4.2.1 实时退款
      • 4.2.2 极速退款
      • 4.2.3 退款查询
    • 4.3 获取授权/UID
      • 4.3.1 获取支付宝UserId(定制接口)
      • 4.3.2 获取微信openId(定制接口)
      • 4.3.3 获取银联用户标识
  • 5.订单分账类接口
    • 5.1 请求分账
      POST
    • 5.2 分账查询
      POST
    • 5.3 分账回退
      POST
  • 7.延时确认类接口
    • 7.1 延迟交易确认
      POST
    • 7.2 延时交易确认查询
      POST
    • 7.3 延时交易确认退款
      POST
    • 7.4 延时交易确认退款查询
      POST
    • 7.5 延迟确认后台通知
      POST
    • 7.6 延迟确认交易极速退款
      POST
  • 8.账户类接口
    • 8.1 转账
    • 8.2 提现(暂不使用)
    • 8.3 账户余额查询
    • 8.4 账户明细查询
    • 8.5 转账/提现查询
    • 8.6 提现后台通知
  • 9.其他辅助类接口
    • 9.1 单笔交易手续费查询
    • 9.2 单笔交易结算查询
    • 9.3 结算结果通知(暂不能使用)
  • 10.对账文件
  • 11.信用付(先享后付)
    • 11.1 微信支付分
      • 需确认模式
        • 11.1.1 创建支付分订单
        • 11.1.2 查询支付分订单
        • 11.1.3 取消支付分订单
        • 11.1.4 确认订单回调通知
        • 11.1.5 完成支付分订单
        • 11.1.6 登记扣款信息
        • 11.1.7 查询扣款信息
        • 11.1.8 微信分代扣
        • 11.1.9 主动支付成功通知
        • 11.1.10 关闭支付分订单
    • 11.2 支付宝芝麻分
  • 12.预付卡支付
    • 12.1 预付卡余额支付
  • 13.营销类接口
    • 13.1 手续费营销
      • 13.1.1 手续费营销商户报名
      • 13.1.2 手续费营销商户活动查询
      • 13.1.3 手续费营销商户报名终止
      • 13.1.4 手续费营销商户报名查询
    • 13.2 微信支付宝营销活动
      • 13.2.1 渠道图片上传
      • 13.2.2 渠道营销活动新增接口
      • 13.2.3 渠道营销活动查询接口
      • 13.2.4 渠道营销活动更新接口
    • 13.3 银联营销活动
      • 13.3.1 银联营销查询
      • 13.3.2 银联营销余额查询
    • 13.4 指令营销类
      • 13.4.1 营销活动变更
      • 13.4.2 营销活动查询接口
  • 14.QS优化
    • 14.1 特殊费用配置新增
    • 14.2 特殊费用配置更新
    • 14.3 特殊费用配置查询
    • 14..4 指令结算
    • 14.5 指令结算查询
  • F.附录
    • F.1 返回码说明
    • F.2 BankType微信银行类型
    • F.3 fund_channel支付宝渠道
    • F.4 acctClass云闪付账户类型
    • F.5 CertType证件类型
    • F.6 payType交易方式
    • F.7 terminalInfo终端信息说明
    • F.8 acctType账户类型
    • F.9 cardType付款卡类型
    • F.10 cardIssuerCode卡机构编码
    • F.11 云闪付云微笔笔支付小程序说明
    • F.12 transType交易类型
    • F.13 dgtlEnvlp 参数说明(付款)
    • F.14 商户类型所需图片
    • F.15 JSAPI预下单后 微信/支付宝调起支付步骤
    • F.16 扫码支付微信支付开户意愿确认、支付宝商家认证流程
    • F.17 银联二维码云微支付小程序说明
    • F.18 银联无感支付云微小程序调用说明
    • F.19 businessCode 字段传值
    • F.20 商户调起微信分小程序说明
    • F.21 银联二维码qrCode说明
    • F.22 白条 orderInfo/goodsInfo 参数附加说明
    • F.24 非收单会员sceneFunctionList
  • FAQ
    • 付款码支付验密规则说明
    • 微信主扫方案
    • 常见问题
  • 易企通1.0防腐层接口
    • 聚合支付
      • 标准-付款码支付
      • 主扫
      • 标准-JSAPI支付
      • 银联JS-获取用户标识
      • 银联JS-获取临时用户授权
      • 银联云闪付app支付(原云闪付控件支付)
      • 获取微信openid
    • 交易
      • 分账
        • 请求分账
        • 分账撤销
        • 分账接收方请求绑定
        • 分账绑定关系查询
        • 分账请求结果查询
        • 分账子单详情结果查询
        • 分账回退
      • 退款
        • 实时退款
        • 退款查询
        • 极速退款-账户代扣(防腐层新)
        • 交易已退已分账头寸查询
      • 担保
        • 担保申请
        • 担保撤销
        • 担保确认
        • 担保查询
      • 清算
        • 秒到交易查询(老-防腐层)
        • D1和T1交易结算查询
        • 商户余额查询
      • 标准-交易单笔查询
      • 标准-交易支付成功通知
      • 标准-关闭订单
  • 回收站
    • 防腐层
      • 微收单优化
        • 代付API
          • 代付处理
        • health-check-controller
          • check
          • check
          • check
          • check
          • check
          • check
          • check
          • check
        • 清算相关查询API
          • 秒到交易查询
          • 秒到交易查询(老)
          • 无交易退款
        • 通知API(内部)
          • 标准-代付后台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 交易前台通知
          • 退款后台通知
        • 机构信息API
          • 机构信息新增
          • 机构信息查询
        • 退货API
          • 极速退货-账户代扣
        • spring-bean-test-controller
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getAllServiceBeans
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • getServiceMethodMetadata
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
          • testSpringServiceMethod
        • 交易API
          • wxAppId可由前端传过来的-微信jsapi支付
    • 6.付款类接口
      • 6.1 付款
      • 6.2 付款查询
      • 6.3 付款(专)
      • 6.4 付款查询(专)
      • 6.5 代付后台通知
    • 通知接口
      • 消费通知接口
      • 分账通知接口
    • 会员商户操作审核
    • 商户协议签约
    • 开户
    • 商户开户
    • 3.1.2 商户信息录入(已废)
    • 3.1.3 商户信息变更(已废)
    • 3.1.4 修改商户经办人手机号
    • 3.1.5 会员商户状态管理
    • 3.3.2 终端机具号更新
    • 3.7.3 商户网联报备申请
    • 3.7.4 新增渠道商户路由
    • 3.8.2 渠道营销活动元数据选项查询
    • 4.3.4 获取支付宝授权
    • 4.3.5 获取微信授权
    • 4.8.6 获取银联授权
    • 8.7 提现(专用)
    • 9.2 商户费率查询
    • 11.1.9 主动支付预下单通知
    • 11.1.4 确认订单回调通知2
    • 11.1.9 主动支付结果通知2
    • 商户终端密钥重置
  1. 1.总体介绍

1.3 业务接入指引

0. 联调总体说明#

未命名文件 (3).jpg

1. 电子协议#

1.1 接入流程#

电子协议接入流程.jpg

1.2 进件前签约#

(建议使用本模式)
进件前签约.png
1.
调用3.5电子协议相关接口,完成电子协议签署,获得电子协议号;
2.
调用“3,1,1图片上传”接口,将图片上送给易生,易生返回图片唯一ID;
3.
调用“3.1.2商户信息录入”接口,将商户信息及图片唯一ID、协议号上送给易生,易生返回商户唯一标识;
4.
如在第3步上送了通知地址,易生会异步将审核结果通知到该地址;如未上送,可调用“3.1.6申请单状态查询”接口,使用申请单编号查询审核状态。

1.3 进件后签约(目前2.0暂不支持)#

进件后签约.png
1.
调用“3.1.1图片上传”接口,将图片上送给易生,易生返回图片唯一ID;
2.
调用“3.1.2商户信息录入”接口,将商户信息及图片唯一ID上送给易生,易生返回商户唯一标识;
3.
如在第2步上送了通知地址,易生会异步将审核结果通知到该地址;如未上送,可调用“3.1.6申请单状态查询”接口,使用申请单编号查询审核状态
4.
调用3.5电子协议相关接口,完成电子协议签署,获得电子协议号;
5.
调用“3.1.3商户信息变更”接口,将电子协议号送给易生。

2. 订单分账#

1.
基于原支付订单,提供逐笔订单分账功能。
2.
主单清算标识是否分账(splitSettleFlag)送1,通过接口中分账信息字段(separateInfo)上送分账子单明细。
3.
支持支付请求中同步上送分账信息、支付后异步上送分账信息两种模式。
4.
分账资金到账周期、到账方式,需提前为商户或分账接收方开通和配置,分账受理成功后按配置到账。
5.
交易后分账场景下,交易后30日内,在剩余可分账金额大于0的情况下,可多次发起分账,最多40次。
6.
手续费承担:
6.1 支持按订单上送手续费承担明细(sepaFeeAmount、sepaFeeRatio);
6.2 支持各方按分账金额占订单金额的比例各自承担手续费、其中一方全额承担手续费。

2.1 交易中分账#

订单中分账.png
1.
调用“3.1.2商户信息录入”或“3.1.3商户信息变更”接口,为新增商户或存量商户开通分账业务;
2.
调用3.2.1-3.2.3相关接口,完成分账接收方信息录入;
3.
调用3.2.4-3.2.5相关接口,完成分账接收方与商户的分账关系绑定;
4.
调用“4.条码类交易接口”,接口中同时上送分账子单明细,发起支付申请;
5.
等待易生按照商户、分账接收方预先配置的结算周期和方式完成结算。

2.2 交易后分账#

订单后分账.png
1.
调用“3.1.2商户信息录入”或“3.1.3商户信息变更”接口,为新增商户或存量商户开通分账业务;
2.
调用3.2.1-3.2.3相关接口,完成分账接收方信息录入;
3.
调用3.2.4-3.2.5相关接口,完成分账接收方与商户的分账关系绑定;
4.
调用“4.条码类交易接口”,发起支付申请,交易中暂不上送分账子单明细;
5.
针对已成功的支付交易,在交易后30天内,调用“5.1分账请求”接口,上送分账子单明细,发起分账请求;
6.
等待易生按照商户、分账接收方预先配置的结算周期和方式完成结算。

3. 营销#

3.1 toB指令营销#

定义:由出资方出资补贴给商户的营销活动,例如手续费减免、订单补贴。
开通流程:
商户、出资方:明确营销活动规则,包括活动时间、预算金额等。
出资方与易生签署营销活动协议。
开通营销出资方客户号:联系客户经理(需要有协议)
线下银行转账至易生ACS账户:联系客户经理确认转账备注说明,转账成功后会自动上账到出资方客户号的现金户
完成营销活动配置,获得营销活动ID:联系客户经理,活动创建成功后,会将活动预算金额从现金户中扣除,转入营销账户。
在marketingOrders中上送营销活动ID、营销金额信息。
易生按商户结算周期,将营销资金划付给商户。
易生不对营销资金开票。

3.2 toC指令营销#

定义:出资方出资补贴给C端付款用户的营销活动,实付金额减少,优惠金额一并结算给商户
业务流程
商户、出资方:明确营销活动规则,包括活动时间、预算金额等。
出资方与易生签署营销活动协议。
开通营销出资方客户号:联系客户经理(需要有协议)
线下银行转账至易生ACS账户:联系客户经理确认转账备注说明,转账成功后会自动上账到出资方客户号的现金户
完成营销活动配置,获得营销活动ID:联系客户经理,活动创建成功后,会将活动预算金额从现金户中扣除,转入营销账户。
在marketingOrders中上送营销活动ID、营销金额信息。
易生按商户结算周期,将营销资金划付给商户。
易生不对营销资金开票。

4. 极速退款#

4.1 适用场景#

定义:实时原路退回给付款方,支持全额退或部分退,适用于客户预存退款资金至虚拟账户中,退款资金从余额中实时扣除的场景。例如:
商户要求结算与退款收支两条线:不从待结算金额中扣除退款资金。
分账后退款:因交易资金已分账结算给分账接收方,退款的资金需要商户预存至我司,并线下与分账接收方完成资金往来处理。通过本接口发起退款,退款资金从商户预存账户余额中扣除。

4.2 开通流程#

请联系客户经理。

5. 终端管理#

5.1 机具入库说明#

业务场景:
1.
使用易生机具+不通过接口进件
2.
使用易生机具+通过接口进件
3.
携机入网+不入库+通过接口进件
4.
携机入网+入库+通过接口进件
机具入库管理.jpg

5.2 首次新增终端#

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

5.3 增机#

定义:对已装机的商户新增终端,包括在存量门店下新增终端、新门店下新增终端。
增机2.jpg

5.4 换机#

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

5.5 撤机#

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

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)。
与易生完成联调后,需要商户提交上线材料(含完整业务场景流程录屏),完成审核后,线下通知商户正式投产。
image.png

6.5 业务流程#

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

6.5.1 创建微信分服务单#

以下为需确认模式:
创建需确认订单模式.jpg

6.5.2 用户主动支付#

主动付款.jpg

6.5.3 后台代扣#

后台代扣.jpg

7 云微笔笔支付#

7.1 定义#

7.2 适用场景#

7.3 业务流程#

7.4 联调说明#

(1). 联调前准备:
客户经理与运营部确认分公司是否已有银联全渠道机构号,如否,需要协同运营部去银联申请
客户经理协同运营部去银联(银联分公司),为商户申请开通云微笔笔支付(对应银联产品包0418),获得银联商户号。
(2). 联调说明:
需要使用在生产环境获得的银联商户号,在联调环境做测试,联调前提供给联调技术支持人员做配置,以获得联调参数。
由于涉及商户客户端调起云闪付微信小程序,此流程仅支持生产环境做验证,建议商户在联调环境完成下单(4.1.4云闪付APP支付)的联调,能正常获得响应后,使用生产环境客户端调起微信分做验证。
上一页
1.2 名词解释
下一页
1.4 版本说明
Built with