易生接口联调指南#

联调流程#

示例报文#

测试环境参数信息获取#

公私钥 下载#

私钥#

公钥#

业务分类#

进件（入网）#

获取测试参数#

// 进件 测试环境参数
机构号（clientCode）：61165070
渠道密钥：EDferdssserrtXDe

权限编号：02100113h5
渠道编号：D01X66666667025

资源#

进件流程：https://doc.eycardp.cn/web/#/23?page_id=373

商户信息录入： https://doc.eycard.cn/web/#/23?page_id=3833

等等

图片上传 https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/agent/api/imgUpl

除图片上传外，其他接口测试地址：https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/agent/api/gen

微收单2代（微收单优化、易企通）#

获取测试参数#

客户编号(orgId): ORG000000004785
交易商户号(orgMercode): 531000013010845
交易终端号(orgTermno): 32812114
私钥：BZ0002toORG000000000006.key （联调指南里有公私钥可以下载，在本文档公私钥下载章节能找到）
appid: wxbd3ec1f45c6fbd01
备注:
微信支付宝为真实交易,但是不会产生清算资金划拔，所以使用测试商家账号时请务必使用小于1元的小金额。
请务必在支付当日完成退款，否则因隔日退款失败造成的测试资金损失由测试机构自行承担，并视为放弃资金。

若接入小程序则需要提供
1.主体名称 2.appid

若接入公众号（或H5）支付则需要提供
1.主体名称 2.appid 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

云易收（云收银）#

获取测试参数#

若接入云收银 H5 支付则需要提供
1.主体名称 2.appid 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

资源#

接口文档和请求地址#

电子协议 制作合同模板工具#

易生 提供的 标准模板#

特约商户（两方）受理支付业务协议.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、请不要对字段进行换行
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

"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. 线上的电子协议（进件流程1）#

2. 线上的电子签约（进件流程2）#

3. 线下的纸质协议#

在进件的 商户信息录入 接口 提交的 图片参数， 这10-协议 就是线下的纸质协议，参考 报文元数据 图片参数 说明如下图， 10-协议

微收单1代（逐渐不维护，不再对接）#

获取测试参数#

渠道编号：D01X66666666863
商户编号：531000013010849
终端编号：32812122
渠道秘钥：EDferdssserrtXDe
签名秘钥：rkdff4dvldkk512dddd5rloo2dlliild

openid 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://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

分账（也叫 捷账通）#

资源#

添加个人收款方 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

分账流程（接口文档）#

订单系统#

获取测试参数#

机构号(clientCode): ** **8888888
密钥(signKey): ** **fsdfwerewrfe

商户号: 831450072980001
终端号: 30000656
授权码 30000656 操作员 01 0000

77777775激活后 商户号是15个5 终端号是77777775

资源#

交易信息查询 https://doc.eycard.cn/web/#/217?page_id=3127

订单创建 https://doc.eycard.cn/web/#/217?page_id=3127

订单关闭 https://doc.eycard.cn/web/#/217?page_id=3127

订单拉取（这个） https://doc.eycard.cn/web/#/217?page_id=3127

https://mtest.eycard.cn:4443/AG_MerchantManagementSystem_Core/agent/api/gen

协议支付（云易收里的功能）#

获取测试参数#

验收事项#

请按业务下载对应的验收单

进件、电子协议 请下载下面这个
易生支付系统对外服务接口规范-联调验收单-进件&电子协议.xlsx

微收单2代（又叫微收单优化、易企通）、
云收银（又叫 云易收）、
微收单1代（又叫微收单）、
分账、
易生代付、
智能POS、
等等， 请下载下面这个
易生支付系统对外服务接口规范-联调验收单 (5).xlsx

POS （用不到这个）
易生支付POSP支付-联调验收单.xlsx