易生接口联调指南
联调流程
2.【填写验收文档】——易生技术支持会对验收文档进行验证。参考【验收事宜】
3.【走正式环境流程】测试环境完成验收过后，会由客户经理提交上线流程，正式流程走完后，运营会分配正式环境数据（包括正式参数、正式地址等信息）。
示例报文
2.
测试环境参数信息获取
微信支付宝为真实交易,但是不会产生清算资金划拔，所以使用测试商家账号时请务必使用小于1元的小金额。
请务必在支付当日完成退款，否则因隔日退款失败造成的测试资金损失由测试机构自行承担，并视为放弃资金。
公私钥 下载
私钥
微收单2代 和 云收银 会用得到公钥
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCAqRw0nZ1rGTpAeKupP7coS+en6BveJL4aFVt9men4Zzkpuv/IeK6YJ2yk4m8ppZ7TLW4t5WsPEhYOnUfMtjhW4nuQfjgU54juJ1KMHYiX9gaaO+z80ZnaiKD2YsZMFiE9dlTeBlkRL5xXbHa+JonHfVKXMr13oI8oZNKdpnvknQIDAQAB
业务分类
进件（入网）
获取测试参数
// 进件 测试环境参数
机构号（clientCode）：61165070
渠道密钥：EDferdssserrtXDe权限编号：02100113h5
渠道编号：D01X66666667025
资源
https://doc.eycard.cn/web/#/23?page_id=373
newJinjianDemo.7z
mcc.csv mcc传 mcc_name的四位阿拉伯数字
地区码.xlsx 这个是 商户区域：银联地区码； 传具体“区县”的 YL_CODE， 不是“市”的YL_CODE（所有区县的YL_PR = 市级的YL_ID，所有市级的YL_PR = 省级的YL_ID，所有省级的YL_PR = 0） select * from CS_YL_AREA;
行号行名.xlsx 行号会根据人行数据不定时更新 ZFXT_HH 这一列是 开户行行号， ZFXT_SSHH：所属直接参与者行号；ZFXT_HBDM：行别代码；ZFXT_CSDM：这列不知道
微收单2代（微收单优化、易企通）
获取测试参数
客户编号(orgId): ORG000000004785
交易商户号(orgMercode): 531000013010845
交易终端号(orgTermno): 32812114
私钥：BZ0002toORG000000000006.key （联调指南里有公私钥可以下载，在本文档公私钥下载章节能找到）
appid: wxbd3ec1f45c6fbd01
备注:
微信支付宝为真实交易,但是不会产生清算资金划拔，所以使用测试商家账号时请务必使用小于1元的小金额。
请务必在支付当日完成退款，否则因隔日退款失败造成的测试资金损失由测试机构自行承担，并视为放弃资金。
若接入小程序则需要提供
1.主体名称 2.appid若接入公众号（或H5）支付则需要提供
1.主体名称 2.appid 3.授权目录
关于授权目录，可以参考 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_3
备注:
微信支付宝为真实交易,但是不会产生清算资金划拔，所以使用测试商家账号时请务必使用小于1元的小金额。
请务必在支付当日完成退款，否则因隔日退款失败造成的测试资金损失由测试机构自行承担，并视为放弃资金。
资源
C#: https://gitee.com/easypay_debug_support/easypay-signure-net
JAVA: https://gitee.com/easypay_debug_support/easypay-signure
下面是各个功能 主要的类微收单优化/微收单2代 MobilePayment 微收单1代 MicroAcquiring 分账类及退款类交易 Ledger 云收银/云易收 CloudCashier
云易收（云收银）
适用场景：APP、PC、H5。
获取测试参数
若接入云收银 H5 支付则需要提供
1.主体名称 2.appid 3.授权目录
关于授权目录，可以参考 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_3
orgId: ORG000000009040
orgMercode: 531000013021630
orgTermno: 32825585
私钥：BZ0002toORG000000000006.key （在联调指南——公私钥下载章节下载私钥信息）
openId：传-
appid: 不要传（如果生产环境上传"-"，需要联系技术人员进行配置，由易生帮忙获取openid）
openid：H5预下单必填，小程序预下单可不填
备注:
微信支付宝为真实交易,但是不会产生清算资金划拔，所以使用测试商家账号时请务必使用小于1元的 小金额。
请务必在支付当日完成退款，否则因隔日退款失败造成的测试资金损失由测试机构自行承担，并视为放弃资金。
资源
C#: https://gitee.com/easypay_debug_support/easypay-signure-net
JAVA: https://gitee.com/easypay_debug_support/easypay-signure
下面是各个功能 主要的类微收单优化/微收单2代 MobilePayment 微收单1代 MicroAcquiring 分账类及退款类交易 Ledger 云收银/云易收 CloudCashier
电子协议
获取测试参数
电子协议渠道编号（channelId）：616161622101901
电子协议商户编号（merId）：MER021322101901
电子协议终端编号（termId）：TE101901
电子协议签名秘钥：5q0067j7o0cqez9zkk8qrd7zb0e849c9i
模板编号（templateId）：QT_18432
电子协议渠道编号（channelId）：616161622120100
电子协议商户编号（merId）：MER021322120100
电子协议终端编号（termId）：TE120100
电子协议渠道密钥：85cjjgs87779x2
电子协议签名秘钥：y592674xy4240p27zbnte0a0elkkyspkv
模板编号（templateId）：QT_22325
电子协议渠道编号（channelId）：616161622120101
电子协议商户编号（merId）：MER021322120101
电子协议终端编号（termId）：TE120101
电子协议渠道密钥：g34u2503lv4xi9
电子协议签名秘钥：z3niatqcdl3g2hsxl5kdpna7pskdygcz
模板编号（templateId）：QT_22325
资源
接口文档和请求地址
电子协议系统对外服务接口规范-v3.2【对外版】 (1)(1)(1).pdf
电子协议 制作合同模板工具
链接：https://pan.baidu.com/s/1k-lXlyvgI-XK4zj4cubotw
提取码：ms5q
易生 提供的 标准模板
特约商户（两方）受理支付业务协议.pdf
模板编号：QT_18432易生签名域：s0
另外一方签名域：s1;s2文本域： 建议商户用百度网盘那个工具自己检测 哪个文本域对应的是哪个KEY
文本域字段说明.xlsx
merName;merLegal;merAddr;contractDateYear;contractDateMonth;contractDateDay;merCode;bizName;businLic;bizAddr;legalCode;legalPhone;linkMan;linkmanPhone;actualBeneficiary;accName;bankName;account;businScope;otherTermTypeName;termMaintain;termPossess;termNum;codeNum;chargeTypeDebit;chargeTypeDebitMax;chargeTypeCredit;chargeTypeUnionpayDebit;chargeTypeUnionpayDebitMax;chargeTypeUnionpayCredit;chargeTypeUnionpayDisDebit;chargeTypeUnionpayDisDebitMax;chargeTypeUnionpayDisCredit;chargeTypeWxpay;chargeTypeAlipay;d1SettlementRatio;d1SettlementFee;d0SettlementRatio;chargeTypeVISA;chargeTypeMastercard;chargeTypeJCB;chargeTypeOther;chargeTypeDCC;posRentalDepositMonth;posRentalDeposit;posBuy;simFee;eRMBServiceMail;otherServices;manager;managerPhone;contractDate;checkChainNo;checkChainYes;checkTermTypeYx;checkTermTypeWx;checkTermTypeWl;checkTermTypeZn;checkTermTypeQrcode;checkTermTypeOther;checkSameCard;checkSettleT1;checkSettleD1;checkSettleD1Ratio;checkSettleD1Fee;checkSettleD0;checkSettleCycleDay;checkSettleCycleMounth;checkAbroadCardYes;checkAbroadCardNo;checkRefundTermYes;checkRefundTermNo;checkRefundSysYes;checkRefundSysNo;checkPosRent;checkPosBuy;checkSimYes;checkSimNo;checkServiceERMB;checkServiceOther
模板编号：QT_22325 易生签名域： ys_sign
甲方签名域：partyA_sign
丙方签名域: partyC_sign
三方分账协议语雀版.pdf文本域：（建议 使用 电子协议 制作合同模板工具 进行检测 文本域的位置）
partyA_name;partyA_legalPerson;partyA_address;partyC_name;partyC_legalPerson;partyC_address;partyA_authName;year1;month1;day1;ys_authName;year2;month2;day2;partyC_authName;year3;month3;day3;enterpriseName;officeAddress;registerEmail;bindPhone;kefuPhone;payAccountName;account;use;servicePerson;servicePerson;servicePersonEmail;technologyPerson;technologyPersonPhone;technologyPersonEmail;moneyPerson;moneyPersonPhone;moneyPersonEmail;businessLicenseNumber;registerMoneyCurrency;businessLicenseBeginEndDate;merArea;legalName;legalIdTypeAndNumber;legalId_PeriodOfValidity;merShortForWebsite;WebsiteICPRecordNo;merWebsite;settlementBankAccountName;settlementOpenBank;settlementBankAccount;protocolSignDate;protocolEndDate;r_systemAutoSettlement;r_noticeSettlement;actualbeneficiaryPersonName;actualbeneficiaryPersonIdMsg;actualbeneficiaryPersonAddress;authorizedBusinessPersonName;authorizedBusinessPersonIdMsg;scopeOfBusiness;addMerSignDate;note;r_onlineBankPay_personal;onlineBankPay_personal_PeriodOfSettlement;onlineBankPay_personal_ServiceCharge;r_onlineBankPay_enterprise;onlineBankPay_enterprise_PeriodOfSettlement;onlineBankPay_enterprise_ServiceCharge;r_ys;ys_PeriodOfSettlement;ys_ServiceCharge;r_quickPay_un;quickPay_un_PeriodOfSettlement;quickPay_un_ServiceCharge;r_protocol;protocol_PeriodOfSettlement;protocol_ServiceCharge;r_unOnline;unOnline_PeriodOfSettlement;unOnline_ServiceCharge;r_cloudApp;cloudApp_PeriodOfSettlement;cloudApp_ServiceCharge;r_unQrcode;unQrcode_PeriodOfSettlement;unQrcode_ServiceCharge;r_wechatScan;wechatScan_PeriodOfSettlement;wechatScan_ServiceCharge;r_wechatJs;wechatJs_PeriodOfSettlement;wechatJs_ServiceCharge;r_aliPayScan;aliPayScan_PeriodOfSettlement;aliPayScan_ServiceCharge;r_aliPayHtml;aliPayHtml_PeriodOfSettlement;aliPayHtml_ServiceCharge;warningTitle;merAuthName;year1;month1;day1;year2;month2;day2;year3;month3;day3;year4;month4;day4;year5;month5;day5;
录制的视频（推荐看一下）
总体流程
1、
2、后台版：我司开放短信验证码发送接口给接入方，接入方自行提供页面给签署方输入验证码后完成签约——由接入方自行上送签约方法人或联系人手机号（目前系统对此无校验），适用于先签约后进件的场景（进件接口中上送协议id或协议图片）（对接接口 就用后台版就行了，电子协议主要就是用后台版的）
**3、页面版：**易生会触发签约H5页面，用户在H5页面完成签约。
1.
一：可以由贵公司编写好协议模板（这种需要使用易生提供的“百度网盘工具”完全自定义文本域和签名域，编写好的话，需要易生法务进行审核，确认协议没有问题，到时候交给我去配置，但这种一般比较费时间）
二：也可以由易生提供协议模板， 请查看本文档 电子协议-资源-中的《易生 提供的 标准模板》 （为了接入方便，大多商户会选择这种方式）（这个 _《易生 提供的 标准模板》 _已经包含了文本域和签名域的协议模板，贵公司可以用易生提供的“百度网盘工具”进行查看已经设置好的文本域和签名域。如果文本域和签名域符合贵公司的需求，那可以不用修改，也可以根据贵公司自身的情况对签名域和文本域进行调整）
2.
3.
4.
5.
6.
7.
8.
文本域和签名域
1.
[获取签名 key 接口](https://doc.eycard.cn/web/#/p/52808ad36e484907ab75e97b564ab144)这个接口不用调用，直接使用易生分配的签名密钥，生产环境需要调用，[获取签名 key 接口](https://doc.eycard.cn/web/#/p/52808ad36e484907ab75e97b564ab144)这个接口的sign所用到的主密钥就是 渠道秘钥，这渠道秘钥都会提供的2.
印章类接口，一般不需要接入（你在签署合同的时候系统会自动加上印章）3.
以下是要注意的地方
什么是文本域和签名域
签名域 就是 合同中 盖章的地方，在接口交互中 使用 用key表示， 比方说 在电子合同中某两处地方需要盖章，位置分别是s1 和 s2表示， 在 签署合同 接口中 signLocation："s1;s2" ，则就能盖章
1.
2.
如何查看文本域和签名域
找到 易生提供的 标准模板，然后拖入到 该工具中。
关于 需要提供的 “文本域”
1、请使用英文格式分号 ; 对每个字段进行分隔
2、请不要对字段进行换行
3、只需要提供文本域，一定不要有签名域！
例如
name00;name0;s1date;s2date;1;2;3;4;5;6;7;8;9;10;11;12;13;14;15;16;17;18;19;20;21;22;23;24;25;26
1.
a. 易生参与， 不需商户提供userId信息
b. 易生不参与， 需要商户提供“固定方的userid”
2.
a. 易生参与， 需要商户提供“固定方的userid” （暂不支持 另外两方都是不固定的情况）
b. 易生不参与， 需要商户提供另外两个固定方的userid
3.
userid 可以通过 个人开户或企业开户接口 得到
双方 易生参与
"createContract": {
"signInfos": [
{
"projectCode": "37cb80032dbf47e7b12fd13a7a0c2b52",
"location": "192.168.22.18",
"signLocation": "另外一方的签名域1;签名域2",
"authorizationTime": "20211221160341",
"isProxySign": "1",
"userId": "D3A2E24DBEF40A7BE05312016B0AEFCB"
}
],
"signLocation": "易生签名域",
"textValueInfo": {
"11": "address",
},
"templateId": "MM_8475",
"isSign": "1"
}
协议 和 进件的 关系
1.
2.
3.
1. 线上的电子协议（进件流程1）
1.
2.
1.
2.
3.
2. 线上的电子签约（进件流程2）
1.
2.
3.
3. 线下的纸质协议
微收单1代（逐渐不维护，不再对接）
获取测试参数
渠道编号：D01X66666666863
商户编号：531000013010849
终端编号：32812122
渠道秘钥：EDferdssserrtXDe
签名秘钥：rkdff4dvldkk512dddd5rloo2dlliildopenid obmoR5FXrSEI4uvHVJAigyYJvUTU
subappid wxded3c555de76c29b
"channelid": "D01X20200424011",
"merid": "531000012989458",
"termid": "32790065",
渠道秘钥 fudhsyrgnbpdeibh
签名秘钥：s2i3d4423k3d131i21jvd58j5dd1rddj"openid": "2088402489184084",
资源
付款码支付 https://doc.eycard.cn/web/#/42?page_id=543
主扫支付 https://doc.eycard.cn/web/#/42?page_id=547
公众号/服务窗支付 https://doc.eycard.cn/web/#/42?page_id=546
交易查询 https://doc.eycard.cn/web/#/42?page_id=548
等等
http://180.168.215.67:8085/WorthTech_Access_AppPaySystemV2/apppayacc** （用这个）**
C#: https://gitee.com/easypay_debug_support/easypay-signure-net
JAVA: https://gitee.com/easypay_debug_support/easypay-signure
下面是各个功能 主要的类微收单优化/微收单2代 MobilePayment 微收单1代 MicroAcquiring 分账类及退款类交易 Ledger 云收银/云易收 CloudCashier
MISPOS 对接
智能POS对接
易生鉴权
获取测试参数
渠道编号（channelId）：616161622110300
商户编号（merId）：MER021322110300
终端编号（termId）：TE110300
渠道秘钥：14jsa1y72a7f8d
签名秘钥：1dqh76i2212f2f8y5736401e6i524rec1
资源
https://doc.eycard.cn/web/#/27?page_id=406
请求地址：https://api-test.eycard.cn:9443/EasypayMPSystem/[urlmethod]
银行卡信息鉴权：https://api-test.eycard.cn:9443/EasypayMPSystem/VerifyBankServet
通讯运营商信息鉴权: https://api-test.eycard.cn:9443/EasypayMPSystem/VerifyOperatorServet
公安信息鉴权: https://api-test.eycard.cn:9443/EasypayMPSystem/VerifyPoliceServet
风险信息鉴权: https://api-test.eycard.cn:9443/EasypayMPSystem/QueryRiskServet
鉴权结果查询: https://api-test.eycard.cn:9443/EasypayMPSystem/VerifyQueryServet
EasypayVerify.7z
分账（也叫 捷账通）
资源
添加个人收款方 https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/jzt/api/pri
添加企业收款方 https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/jzt/api/ent
收款方变更 https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/jzt/api/分账请求地址： https://t-wapi.bhecard.com:6111+[urlmethod]
请求分账 https://t-wapi.bhecard.com:6111/ledger/mpos
分账撤销 https://t-wapi.bhecard.com:6111/ledger/mposcancel
分账结果查询 https://t-wapi.bhecard.com:6111/ledger/mposfind
分账关系绑定 https://t-wapi.bhecard.com:6111/ledger/mposbind
分账关系查询 https://t-wapi.bhecard.com:6111/ledger/mposfindbind
C#: https://gitee.com/easypay_debug_support/easypay-signure-net
JAVA: https://gitee.com/easypay_debug_support/easypay-signure
下面是各个功能 主要的类微收单优化/微收单2代 MobilePayment 微收单1代 MicroAcquiring 分账类及退款类交易 Ledger Merchant 云收银/云易收 CloudCashier
分账流程（接口文档）
1.
2.
3.
4.
5.
杰德 商户号：531000012972421 终端号：W1489524
订单系统
（1）5.2 订单创建：商户系统把订单推送到易生后台
（2）5.3 订单关闭：如果商户系统关闭订单，通知易生后台
（3）POS上点查询，查出单笔订单，完成支付（接口6.1，为易生内部接口，合作方不用联调）
（4）POS支付完成后告诉易生后台支付结果 （接口6.2，为易生内部接口，合作方不用联调）
（5）5.1 交易信息查询接口：合作方主动查询订单状态。
（6）结果通知接口：合作方提供一个生产地址，客户经理找运营部关云超开通权限，把结果通知推送到合作方给的网址上。
获取测试参数
机构号(clientCode): ** **8888888
密钥(signKey): ** **fsdfwerewrfe商户号: 831450072980001
终端号: 30000656
授权码 30000656 操作员 01 000077777775激活后 商户号是15个5 终端号是77777775
资源
https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/agent/api/gen
结果通知格式-210324.doc 结果通知接口，是支付完成后，将推送到合作方给的URL
协议支付（云易收里的功能）
获取测试参数
验收事项
将“需要接入的接口”的请求报文和响应报文等信息填入验收文档中，没有接入的接口请空着，最后发到群里，易生技术支持会对数据进行验证，测试环境完成验收过后，会由其他同事提交上线流程，正式流程走完后，会分配正式环境数据（包括正式参数、正式地址等信息）。
请按业务下载对应的验收单
进件、电子协议 请下载下面这个
易生支付系统对外服务接口规范-联调验收单-进件&电子协议.xlsx微收单2代（又叫微收单优化、易企通）、
云收银（又叫 云易收）、
微收单1代（又叫微收单）、
分账、
易生代付、
智能POS、
等等， 请下载下面这个
易生支付系统对外服务接口规范-联调验收单 (5).xlsxPOS （用不到这个）
易生支付POSP支付-联调验收单.xlsx
修改于 2025-02-19 06:32:20