易企通2.0
  1. 2.接口规范
易企通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. 2.接口规范

2.3 参数说明

1、联调参数#

联调测试时候用这套参数。
若参数无法使用，请联系联调支持人员。
【MER_RSA_PRIVATE_KEY（商户私钥）】
商户对自己的请求报文进行加签
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCc1mku1mtfTc1vZM9z3TkRMZ9SaKP+6MdoQhjDHB9vJUOuG2Jnegej4gtzcm8MVYomV1azJMtCbPq4PN9aHegH13JthvrUPR3nAKp8AUp9Fh47ded//snNyAf7C7o8xKN5e7n89ROwacCAL2QDno76ngXzQQVj1TxY9pBdekZ03ezuDk1sv/u4FBlW8kRyaVdqyl4FdvP+EEljDe8gGxRikLyb3cK1B6G7w2BXgM/svft5SOoiqStx2XvgHRrFRB5w96TdoKNH9yxHU2clMJiz+5cej1VL6OHZspuY3cnPyJtyS+weYjDT+COLLBUe9UwbOV15DXDNpBLd34W4GiqtAgMBAAECggEAYaVwmVOwSAblp7wJGScb16OggStbJ2MAe93jEt7Yh1eZGrY7/xbP2O3smTUfBHvhZlusRB7dWf8F3l0v5iiGhRNTT/PhCPEARAl7G3emS9jQe869kkgslq06ose7bQg0i3dH5cEkQAqnameXClXWyRxHshrCY1SonO7uFPUDFtD2Z9GHu6dOWkOHfX7UETHV5/NTSqvner5M2YNsV/5To87zrmaeeNyvu91JgJSYofTD8IcMyhxcswxB9F3ECP7nulLDdCV+9mvE9zO0i4mPBxYb++87J0pu35TN9OY+gpiCK3Ed0gDqvvkTiCQEFu6y7OiqsQwy03CE5hAwWZR2YQKBgQDdb6e7+FWJSr9fIknfvZPPtKmbEkMHP1RYnVo3pmuVm14Z3UmostiSBRPMfVjeOX0N82SONM9P+1v9SDgSK3pL8rlk9Hx6D5KI7uj2IMtTVt00pO31KtxDLmXfgapDbWHK1RGEn1PDrnKYy5yOKJ8n0Wgp4lVEPIBN6uIud0A9iQKBgQC1UXdhEXFETyqEYWb9OnWbBjiVIw3D2/qW5c+WQGsHYdMEImC/0oTWIH9fKd4Azf26JjZ9nQvs5VcijJP6BXbGPqir5NgGVkwCj33PoNg4dDgIVE4BYaSp//7B6jCi5QiRTzCSOmUSkZ5L1Kz4SNEDe9r0MpLhxrsAzmR9aEJ/BQKBgHI71Ks63F2cSwd39+ZNtYA0cj7Gd/+4IvooCs+kseGXKj9rkkFOKj2CEwmuLHdP7vyQcHKQOdbIFFegtxRgi5G8oPm8yq5pdC3iGhpHJr1SlYFACGYu+zxJJlLcYIqyVf2+V3A0hZDwYLwEZjpMKHbxJ6xbz6MJFyObJZ3U9TYJAoGANXoGjJF5Z501u/+CQZN5VjSagZnqGGcL3G+BLx5msrGua9y7zjeHyCOjjWyqtnAKsllM3vVvq/nkHiN6DVaJNmUKmFARSqUvG944TAFzZAsa75H1w8CJsT34ZDbvC0wjn7/MYoRohPZ/ynu6XCwVwUJJTJaR7ZcQVmeJCdezLQUCgYEAszix6V9oL80Clb1nMwIly6I78+pcFKyk82yXxvySb6XPJvgoasbz9xYIeKlPyy6r8Aj/ujz5GVtDtkE6n6bsjekCdnUKUY3uTvFAX+YGQkuZnaPoisELJFI2Hal22tNnJyCOYh//AGAiHYpHNUKD4hsKBb45MhK1xwvTHpuLkdc=
【EASYPAY_PUBLIC_KEY（易生公钥）】
商户用于对易生的响应报文进行验签
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArgVerkGaSEQvZIOpLjeUoVpL0lSYLc04+txtPFtfm5r5XFbaNaf5Ahu0lziGEwWzrGONThSsnb3U9pqoY6BpqviN4h+Guw5oEdHr1T/eDkQD5urgQUaZA6lDoU9XC662r+0kpbKidvXIsK2CrShN+BF8HEJmRZuhglxh25OHWIWqQiUDjLZC+QJRZqUu9Uzy9RBBu7qa0f0xbqYl3hnYi+vH++SsyOavO2gUVQyKU5Kkt5ZJVpZFQvD3BXePgwJSpsvrjhj0hiYp2v6PScN9XHP1vXB4wtIYSFYwmVus1KkV/LfDzUm6zHjliHYTVl6lPMhveIVJlRIqInRZRHxg5QIDAQAB

2、生产参数#

接入方参数#

验收完成后，请联系客户经理获取。
示例：
image.png

请求地址#

https://phoenix.eycard.cn/yqt/+[接对应的urlmethod]
urlmethod获取方法：
image.png

生产环境的易生公钥#

MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCLLVY70e67BcK4V08P+69dfBeMmMYDopf3HF9G6meqPTVxyGYlEb0XwT0UA6g8t2HzG8FaKgTFKgOvhr+EFbBcF+AYdrgFYZSjR4hWBkWiOyKC66wQ7kQhYzC4kwetcDp5TftJfSivbAC1Lm8/Gf2+ZpaDuHDPjLCFS2gQYI5dqwIDAQAB
！！！配置时请注意！！不要有空格！不要有断行！否则会验签失败。
easyPayCertificateId "00000000"

商户秘钥#

商户公钥：提供给易生
商户私钥：商户自行保存用于加签
生成地址：http://web.chacuo.net/netrsakeypair
注意：请务必保存自己的公私钥，不要弄丢了，保存一份最原始的公私钥（就是包含BEGIN END标签的字符串，如下图）
image.png

示例#

📌
从上面网址上你已经获取了 公私钥，假如下面是你得到的是公钥 (请保留一份这个最原始的公钥)
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0B0GyKqo0ZfX/xEwWMBT
rb0ao/pxCDzGRG0apSlOFGlsEtkDIHPdIW9bNV7G9uEyNe9Cba4M+dAWC9awDTk0
wShc+SJoGaRr7rwL2fuKLDFuRTnqQOPezXlhrSzgGSxRlB1nzKY4a5Nk4Vyz+/Z9
EraKEsnYjK0lFOtRUezNWA6k7sSuFHcmLgvyNzBdFQAruB1X16gbJZjWyEyI7n2j
SXqhAoQB59V4x9Jq+3lvqQ8teWdqlvLnWVYTx3F3p0HEieNWAqvww/HNOpm9dh//
4BSAUjBamrjh+YNzhHxGvWMvJ5flRtTtDJmBtkNp85MXQ1xyzjJQbxm3Dgzfty19
zQIDAQAB
-----END PUBLIC KEY-----
将pem格式的转换成字符串 经过去除 BEGIN END标签，和换行后，得到下面这个
这是提供给易生的，但这是示例，请提供 你们自己的，而不是复制下面示例的
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0B0GyKqo0ZfX/xEwWMBTrb0ao/pxCDzGRG0apSlOFGlsEtkDIHPdIW9bNV7G9uEyNe9Cba4M+dAWC9awDTk0wShc+SJoGaRr7rwL2fuKLDFuRTnqQOPezXlhrSzgGSxRlB1nzKY4a5Nk4Vyz+/Z9EraKEsnYjK0lFOtRUezNWA6k7sSuFHcmLgvyNzBdFQAruB1X16gbJZjWyEyI7n2jSXqhAoQB59V4x9Jq+3lvqQ8teWdqlvLnWVYTx3F3p0HEieNWAqvww/HNOpm9dh//4BSAUjBamrjh+YNzhHxGvWMvJ5flRtTtDJmBtkNp85MXQ1xyzjJQbxm3Dgzfty19zQIDAQAB

非对称秘钥校验#

！生成秘钥后，请务必按本说明进行校验。
！提供商户公钥给易生时，请务必检查不能有空格、断行，否则会验签失败！
1.
打开在线校验网站
https://the-x.cn/cryptography/Rsa.aspx
2.
选择密钥类型(RSA或SM2)
image.png
3.
校验公钥值
image.png
能显示-----BEGIN PUBLIC KEY----- 和标识，说明rsa私钥为正确值
如不是-----BEGIN PUBLIC KEY-----，是密钥格式不对，请用户提供pkcs8的公钥
如验签失败，请用户用此在线工具校验私钥的标识，确认公钥和私钥值的标识是否一致。
上一页
2.2 加签验签说明
下一页
3.1 收单商户信息
Built with