2.2会员


1.文件上传

接口说明:

  • 上传文件,返回fileId

请求URL:

  • /comm/uploadFile

请求方式:

  • POST

请求类型:

  • application/json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

fileType

String(1)

文件类型,3:证件材料

fileMd5

String

文件流的MD5值

file

String

文件流,文件流不参与签名

返回参数

参数名

必选

类型

说明

code

String

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

fileId

String(40)

文件标识,长期有效

2.企业会员实名开户

接口说明:

  • 用于企业会员注册

请求URL:

  • /payMember/regEnterprise

请求方式:

  • POST

请求类型:

  • application/json

请求参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

memCategory

String(2)

会员种类:
02-企业
03-个体工商户

memRole

String(11)

会员角色:
引流方
供应商
chanNo为yunst2isv时必填

memSubType

String(1)

会员子类型:2-分账方
chanNo为yunst2isv时必填

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代isv:yunst2isv

notifyUrl

String(250)

企业会员开户结果通知地址

memAlias

String(50)

会员简称,可由客户自定义,校验唯一

serialNo

String(32)

请求流水号

enterpriseInfo

String

企业信息
jsonObject格式

bankInfo

String

银行卡信息
jsonObject格式

企业信息:

参数名

必选

类型

说明

companyName

String(50)

企业名称,营业执照名称

companyAddress

String(50)

企业地址

companyAddrCode

String(10)

地区码,见附录[2.省市地区码](https://www.showdoc.com.cn/2511081072137898/11558563513285632 "2.省市地区码")

authType

String(11)

认证类型 2:一证

uniCredit

String(20)

统一社会信用

effLicense

String(20)

统一社会信用生效日期 yyyy-mm-dd

expLicense

String(20)

统一社会信用到期时间 yyyy-MM-dd

legalName

String(10)

法人姓名

identityType

String(1)

证件类型 1-身份证

legalIds

String(160)

法人身份证,aes加密

legalPhone

String(11)

法人手机号

legalIdZFileId

String(30)

法人证件人像面影印件fileId

legalIdFFileId

String(30)

法人证件国徽面影印件fileId

uniCreditFileId

String(30)

统一社会信用代码影印件fileId

银行卡信息:

参数名

必选

类型

说明

acctType

String(1)

账户类型 0-对私 1-对公

acctNo

String(200)

银行卡号 aes加密

bankPhoneNo

String(11)

银行卡绑定手机号,账户类型=0-对私时,则必填

parentBankName

String(20)

开户行名称

openBankNo

String(10)

银行代码,账户类型=1-对公时,则必填,参见[附录3. 银行代码及支付行号](https://www.showdoc.com.cn/tppay/11558620330076069 "附录3. 银行代码及支付行号")

bankName

String(20)

开户行支行名称,账户类型=1-对公时,则必填,参见附录3

unionBank

String(20)

支付行号,账户类型=1-对公时,则必填,参见附录3

openBankProvince

String(20)

开户行所在省,例 江苏省,上送 江苏

openBankCity

String(20)

开户行所在市,例 南京市,上送 南京

返回参数

参数名

必选

类型

说明

code

String

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

bizUserId

String(30)

会员编号

测试环境测试数据模拟规则:

类型

规则

测试环境短信验证码

11111

对私卡绑定规则

{"卡号第四位为0","交易成功"}
{"卡号第四位为1","查开户方原因"}
{"卡号第四位为2","无效卡号 "}
{"卡号第四位为3","已挂失卡"}
{"卡号第四位为4","余额不足"}
{"卡号第四位为5","无此账户"}
{"卡号第四位为6","原交易失败,不收费"}
{"卡号第四位为7","户名错"}
{"卡号第四位为8","交易超时"}

企业会员模拟识别成功结果

企业名称:竹溪县子怡鞋店
认证类型:一证
统一社会信用代码:92420324MA4D68J28J
法人姓名:王三华
法人证件号码:420324197711160623

3.企业会员开户结果通知

请求URL:

  • 该链接是通过企业会员实名开户接口提交的参数notifyUrl设置

请求方式:

  • POST

请求类型:

  • application/x-www-form-urlencoded

通知参数

参数名

必选

类型

说明

orgId

string

服务商id,有此参数需要用服务商密钥进行验签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若是服务商模式,则为服务商appId

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(2)

商户会员编号

chanNo

String(10)

渠道,云商通二代:yunst2isv

auditResult

String(1)

审核结果 2:通过
3:失败

auditTime

String(20)

审核时间 格式:20240226170408

auditRemark

String(200)

人工审核备注

auditResultMsg

String(200)

失败原因

返回结果:

业务系统处理后同步返回给支付系统,返回字符串success 则表示成功,返回非success则表示处理失败,支付系统会再次通知。

注意:返回的字符串必须是小写,且前后不能有空格和换行符。

4.会员资料补录

接口说明:

  • 用于企业会员注册影印件补录

请求URL:

  • /payMember/regSupplement

请求方式:

  • POST

请求类型:

  • application/json

请求参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代isv:yunst2isv

notifyUrl

String(250)

会员资料补录结果通知地址

serialNo

String(32)

请求流水号

uniCreditFileId

String(40)

统一信用证fileId

legalIdZFileId

String(40)

身份证人像面fileId

legalIdFFileId

String(40)

身份证国徽面fileId

返回参数

参数名

必选

类型

说明

code

String

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

bizUserId

String(30)

商户会员编号

5.会员资料补录结果通知

请求URL:

  • 该链接是通过会员资料补录接口提交的参数notifyUrl设置

请求方式:

  • POST

请求类型:

  • application/x-www-form-urlencoded

通知参数

参数名

必选

类型

说明

orgId

string

服务商id,有此参数需要用服务商密钥进行验签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若是服务商模式,则为服务商appId

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代:yunst2isv

enterpriseCompareResult

String(1)

OCR识别与企业工商认证信息是否一致
1-是 2-否 3-识别失败

legalPersonCompareResult

String(1)

OCR识别与企业法人实名信息是否一致
1-是 2-否 3-识别失败

compareResults

String(500)

比对结果信息,多个“;”分隔

enterpriseInfo

JSONObject

企业影印件识别信息

legalPersonCardFaceInfo

JSONObject

法人影印件肖像面识别信息

legalPersonCardNationalEmblemInfo

JSONObject

法人影印件国徽面识别信息

企业影印件识别信息:

参数名

必选

类型

说明

respCode

String(10)

返回码 ,000000 成功,其他失败

respMsg

String(10)

失败原因

result

String(10)

识别结果 0-查询到数据 1-未查到数据

creditCode

String(20)

统一社会信用

corpName

String(200)

企业名称

forever

String(10)

有效期是否永久 true/false

validate

String(30)

有效期 该字段当forever为false时有效,格式:yyyy/MM/dd,如:2999/12/31

法人影印件肖像面识别信息:

参数名

必选

类型

说明

respCode

String(10)

返回码 ,000000 成功,其他失败

respMsg

String(10)

失败原因

result

String(10)

识别结果 0-查询到数据 1-未查到数据

name

String(100)

姓名

idCard

String(30)

身份证号

gender

String(10)

性别

nation

String(30)

民族

birthday

String(10)

生日 格式如:1995/10/08

address

String(500)

地址

法人影印件国徽面识别信息:

参数名

必选

类型

说明

respCode

String(10)

返回码 ,000000 成功,其他失败

respMsg

String(10)

失败原因

result

String(10)

识别结果 0-查询到数据 1-未查到数据

validDate

String(100)

有效期 格式:yyyy/MM/dd-yyyy/MM/dd,如果长期则显示中文

unitName

String(300)

所属公安单位

isValid

String(1)

是否过期 1未过期,0已过期

返回结果:

业务系统处理后同步返回给支付系统,返回字符串success 则表示成功,返回非success则表示处理失败,支付系统会再次通知。

注意:返回的字符串必须是小写,且前后不能有空格和换行符。

6.会员绑定手机号申请

接口说明:

  • 会员绑定手机号申请,用于绑定法人手机号或企业授权手机号

请求URL:

  • /payMember/bindPhoneApple

请求方式:

  • POST

请求类型:

  • application/json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代isv:yunst2isv

serialNo

String(32)

请求流水号

phone

String(11)

绑定手机号

phoneType

String(1)

绑定类型 1-法人手机号 2-企业授权手机号

notifyUrl

String(250)

绑定手机号通知地址

jumpUrl

String(250)

前端跳转地址,仅绑定类型为2且授权类型为1上送,只支持H5

authPerInfo

String

被授权人信息,绑定类型为2,必传
JSONObject格式

被授权人信息:

参数名

必选

类型

说明

authPerType

String(60)

授权类型 1-线上 2-线下

authPerName

String(60)

授权人名称

authPerIdNo

String(200)

授权人证件号 aes加密

authPerIdType

String(2)

授权人证件类型 1-身份证

authProcotolFileId

String(100)

授权协议文件fileId,仅授权类型为2时传

返回参数

参数名

必选

类型

说明

code

String

返回状态:0-处理成功,3000-已受理待审核(线下授权返回),其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

bizUserId

String(30)

商户会员编号

applyRespTraceNum

String(40)

响应流水号

authSignLink

String(255)

授权手机号签约链接,只有绑定类型为2且授权类型是1返回

页面跳转说明:

jumpUrl参数:

参数名

必选

类型

说明

reqTraceNum

String(50)

请求流水号

signNum

String(60)

会员编号 对应入参bizUserId

bindResult

String(1)

绑定结果 1:成功

phone

String(2)

绑定手机号

7.会员绑定手机号确认

接口说明:

  • 会员绑定手机号上送短信验证码

请求URL:

  • /payMember/bindPhoneConfirm

请求方式:

  • POST

请求类型:

  • application/json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代isv:yunst2isv

serialNo

String(32)

请求流水号

applyRespTraceNum

String(40)

申请响应业务关联流水号

phone

String(11)

绑定手机

verifyCode

String(6)

短信验证码

返回参数

参数名

必选

类型

说明

code

String

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

bizUserId

String(30)

商户会员编号

phone

String(30)

手机号

测试环境模拟规则:

类型

规则

测试环境短信验证码

11111

8.会员绑定手机号结果通知

请求URL:

  • 该链接是通过会员绑定手机号申请接口提交的参数notifyUrl设置

请求方式:

  • POST

请求类型:

  • application/x-www-form-urlencoded

通知参数

参数名

必选

类型

说明

orgId

string

服务商id,有此参数需要用服务商密钥进行验签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若是服务商模式,则为服务商appId

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代:yunst2isv

bindResult

String(1)

绑定结果 1:成功 2:失败

bindErrorMsg

String(200)

绑定失败原因

bindTime

String(20)

绑定时间

phone

String(11)

绑定手机号

phoneType

String(1)

绑定手机类型 1-法人手机号 2-企业授权手机号

返回结果:

业务系统处理后同步返回给支付系统,返回字符串success 则表示成功,返回非success则表示处理失败,支付系统会再次通知。

注意:返回的字符串必须是小写,且前后不能有空格和换行符。

9.个人会员实名及绑卡

接口说明:

  • 用于分账方的个人会员实名注册,个人会员实名绑卡后,无需调用会员绑定手机号接口,会员绑定的手机号默认为银行卡预留手机号

请求URL:

  • /payMember/regPerson

请求方式:

  • POST

请求类型:

  • application/json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

memRole

String(11)

会员角色:chanNo为yunst2isv时必填

memSubType

String(1)

会员角色:2-分账方
chanNo为yunst2isv时必填

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代isv:yunst2isv

memAlias

String(50)

会员简称

serialNo

String(32)

请求流水号

memInfo

jsonObject字符串

个人信息

bankInfo

jsonObject字符串

银行卡信息

个人信息:

参数名

必选

类型

说明

idenName

String(32)

姓名

idenNo

String(120)

证件号码,aes加密

identityType

String(1)

证件类型 1-身份证

银行卡信息:

参数名

必选

类型

说明

acctNo

String(200)

银行卡号 aes加密

bankPhoneNo

String(11)

银行卡绑定手机号

validDate

String(4)

有效期,格式为月年;如0321,2位月2位年
说明:针对信用卡,若商户送,则透传渠道

cvv2

String(3)

CVV2
3位数字,
说明:针对信用卡,若商户送,则透传渠道

返回参数

参数名

必选

类型

说明

code

int

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

bizUserId

String(30)

会员编号

模拟规则:

类型

规则

对私卡绑定规则

{"卡号第四位为0","交易成功"}
{"卡号第四位为1","查开户方原因"}
{"卡号第四位为2","无效卡号 "}
{"卡号第四位为3","已挂失卡"}
{"卡号第四位为4","余额不足"}
{"卡号第四位为5","无此账户"}
{"卡号第四位为6","原交易失败,不收费"}
{"卡号第四位为7","户名错"}
{"卡号第四位为8","交易超时"}

10.会员信息查询

请求URL:

  • /payMember/getRegState

请求方式:

  • POST

请求类型:

  • application/json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道
云商通特色结算:yunst2isv
云商通银行账户:yunst2yhzh

返回参数

参数名

必选

类型

说明

code

String

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

memAlias

String(50)

会员简称

memCategory

String(2)

会员种类
01-个人
02-企业对公
03-个体工商户

bizUserId

String(30)

商户会员编号

memSubType

String(1)

会员子类型
1-收款方 2-分账方

memNo

String(30)

通企付会员编号

phoneNo

String(11)

绑定手机号

memInfo

jsonObject

个人信息
会员种类为“01-个人”返回

enterpriseInfo

jsonObject

企业信息
会员种类为“02、03”返回

bankList

jsonArray

绑卡信息

chanList

jsonArray

渠道注册信息

个人信息:

参数名

必选

类型

说明

idenName

String(10)

身份证名称

idenNo

String(18)

身份证号

企业信息:

参数名

必选

类型

说明

companyName

String(50)

企业名称

companyAddress

String(50)

企业地址

authType

String(11)

认证类型 1:三证 2:一证

businessLicense

String(50)

统一社会信用代码或营业执照号

organizationCode

String(50)

组织机构代码,三证时返回

taxRegister

String(50)

纳税人识别号,三证时返回

expLicense

String(50)

营业证件有效期

legalName

String(10)

法人姓名

identityType

String(1)

证件类型 1-身份证

legalIds

String(18)

法人身份证

legalPhone

String(11)

法人手机号

accountNo

String(20)

银行账号

parentBankName

String(20)

开户行名称

bankName

String(20)

开户行支行

unionBank

String(20)

支付行号

legalIdZOCRResult

String(1)

法人证件人像面影印件处理结果 0-待上传 1-识别中 2-识别通过 3-识别失败

legalIdFOCRResult

String(1)

法人证件国徽面影印件处理结果 0-待上传 1-识别中 2-识别通过 3-识别失败

uniCreditOCRResult

String(1)

统一社会信用代码影印件处理结果 0-待上传 1-识别中 2-识别通过 3-识别失败

绑卡信息:

参数名

必选

类型

说明

acctType

String(1)

账户类型 0- 对私 1- 对公

acctNo

String(200)

银行卡号

bankPhoneNo

String(11)

银行卡绑定手机号,账户类型=0-对私,则必填

parentBankName

String(20)

开户行名称

openBankNo

String(10)

银行代码,账户类型=1-对公,则必填

bankName

String(20)

开户行支行名称,账户类型=1-对公,则必填

unionBank

String(20)

支付行号,账户类型=1-对公,则必填

openBankProvince

String(20)

开户行所在省,例 江苏省,上送 江苏

openBankCity

String(20)

开户行所在市,例 南京市,上送 南京

注册渠道信息:

参数名

必选

类型

说明

chanNo

String(10)

渠道编码

regState

String(11)

状态
0-初始
1-注册中
2-正常
3-停用

11.会员协议签约申请

请求URL:

  • /payMember/applyMemProtocol

请求方式:

  • POST

请求类型:

  • application/json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

serialNo

String(32)

商户请求流水号

bizUserId

String(30)

收款方商户会员编号

chanNo

String(10)

渠道,云商通二代:yunst2isv

protocolType

String

协议类型 1-分账协议
2-抽佣协议

divisionMemInfo

String

分账协议信息,分账协议必传
JSONObject格式

couponInfo

String

抽佣协议信息,抽佣协议必传

notifyUrl

String(128)

签约结果和审核结果异步回调URL,只有传了该值才会发起回调

jumpPageType

String(1)

跳转页面类型1-H5页面 2-小程序页面,不送默认H5

jumpUrl

String(128)

前端跳转地址

分账协议信息:

参数名

必选

类型

说明

divisionBizUserId

String(10)

分账方商户会员编号

divisionType

String(1)

分账方式 1:分账比例

divisionRate

String(6)

最高分账比例,最多4位小数,如最高分账比例为5.55%,填写0.0555

divisionProcotolFileId

String(100)

分账业务佐证材料的fileId,需要先使用文件上传接口获取

抽佣协议信息:

参数名

必选

类型

说明

couponType

String(1)

抽佣方式 1:分账比例

couponRate

String(6)

具体抽佣比例,最多4位小数,如分账比例为5.55%,填写0.0555

返回参数

参数名

必选

类型

说明

code

string

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

recSignLink

String(512)

收款方签约链接

divSignLink

String(512)

分账方签约链接 , 分账协议返回

protocolLinkEndTime

String(30)

签约链接失效时间 2024-10-10 09:16:00

页面跳转说明:

jumpUrl参数:

参数名

必选

类型

说明

reqTraceNum

String(50)

请求流水号

signNum

String(60)

签约会员编号,同bizUserId

memberName

String(200)

签约会员名称

couponAgreeStatus

String(1)

平台抽佣协议状态 签署抽佣协议返回

couponAgreementNo

String(32)

平台抽佣协议签约编号 签署抽佣协议返回

sepAgreeStatus

String(1)

分账协议状态 签署分账协议返回

sepAgreeNo

String(32)

分账协议编号 签署分账协议返回

       

12.会员协议签约结果通知

请求URL:

  • 该链接是通过会员协议签约申请接口提交的参数notifyUrl设置

请求方式:

  • POST

请求类型:

  • application/x-www-form-urlencoded

通知参数

参数名

必选

类型

说明

orgId

string

服务商id,有此参数需要用服务商密钥进行验签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若是服务商模式,则为服务商appId

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道,云商通二代:yunst2isv

noticeType

String(1)

通知类型 1-签约结果 2-审核结果

protocolType

String(1)

协议类型 1-分账协议
2-抽佣协议

divisionProtocolState

String(1)

分账协议签约状态
1:签约成功
2:签约失败
3:签约中
0:未签约

couponProtocolState

String(1)

抽佣协议签约状态
1:签约成功
2:签约失败
3:签约中
0:未签约

auditResult

String(1)

审批状态 1-通过 2-拒绝 分账协议且通知类型是审核结果时返

auditTime

String(20)

审核时间 格式:20240226170408 分账协议且通知类型是审核结果时返

auditResultMsg

String(200)

拒绝原因 分账协议且通知类型是审核结果返

divisionProtocolNo

String(64)

分账协议编号

divisionMemInfo

JSONObject

分账协议信息

couponProtocolNo

String(64)

抽佣协议编号,分账协议必传

couponInfo

JSONObject

抽佣协议信息,抽佣协议必传

分账协议信息:

参数名

必选

类型

说明

divisionBizUserId

String(10)

分账会员编号

divisionType

String(1)

分账方式 1:分账比例

divisionRate

String(6)

分账比例,例5.55%,返回0.0555

抽佣协议信息:

参数名

必选

类型

说明

couponType

String(1)

抽佣方式 1:分账比例

couponRate

String(6)

抽佣比例,例5.55%,返回0.0555

返回结果:

业务系统处理后同步返回给支付系统,返回字符串success 则表示成功,返回非success则表示处理失败,支付系统会再次通知。

注意:返回的字符串必须是小写,且前后不能有空格和换行符。

13.会员注册邀请码生成

接口说明:

  • 用于会员注册,返回会员信息采集H5页面链接。会员信息如接口有上送,则会在H5页面反显并允许修改。

请求URL:

  • /payMember/generateRegInviteLink

请求方式:

  • POST

请求类型:

  • application/json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

chanNo

String(10)

渠道
云商通特色结算:yunst2isv
云商通银行账户:yunst2yhzh

memCategory

String(2)

会员种类
01-个人
02-企业对公
03-个体工商户
注:yunst2yhzh渠道不支持个人

memSubType

String(1)

会员类型:2-分账方

memRole

String(11)

会员角色,
分账方会员角色有:引流方,供应商
chanNo为yunst2isv和yunst2yhzh时必填

bizUserId

String(30)

商户会员编号

memAlias

String(50)

会员简称

notifyUrl

String(128)

注册成功结果异步回调URL

jumpUrl

String(128)

页面跳转地址,返回拼接bizUserId和 regState

serialNo

String(32)

请求流水号

phoneNo

String(11)

手机号(绑定手机号)
用于页面返显

memInfo

jsonObject

个人信息
memCategory为01-个人可上送
用于页面返显

enterpriseInfo

jsonObject

企业信息
memCategory为02-企业对公 03-个体工商户可上送
用于页面返显

bankInfo

jsonObject

绑卡信息
绑定对私卡可上送
用于页面返显

个人信息:

参数名

必选

类型

说明

idenName

String(10)

身份证名称

idenNo

String(18)

身份证号

企业信息:

参数名

必选

类型

说明

companyName

String(50)

企业名称

companyAddress

String(50)

企业地址

authType

String(11)

认证类型 2:一证

telephone

String(11)

联系电话

legalName

String(10)

法人姓名

identityType

String(1)

证件类型 1-身份证

legalIds

String(18)

法人身份证

legalPhone

String(11)

法人手机号

accountNo

String(20)

企业对公账户

parentBankName

String(20)

开户行名称

bankName

String(20)

开户行支行

unionBank

String(20)

支付行号(12位)

绑卡信息:

参数名

必选

类型

说明

acctNo

String(20)

银行卡号

bankPhoneNo

String(11)

银行卡绑定手机号

返回参数

参数名

必选

类型

说明

code

int

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

regInviteLink

String(512)

注册链接

regInviteLinkEndTime

String(30)

到期时间 2022-10-10 09:16:00

模拟规则:

类型

规则

测试环境短信验证码

11111

对私卡绑定规则

{"卡号第四位为0","交易成功"}
{"卡号第四位为1","查开户方原因"}
{"卡号第四位为2","无效卡号 "}
{"卡号第四位为3","已挂失卡"}
{"卡号第四位为4","余额不足"}
{"卡号第四位为5","无此账户"}
{"卡号第四位为6","原交易失败,不收费"}
{"卡号第四位为7","户名错"}
{"卡号第四位为8","交易超时"}

企业会员模拟识别成功结果

企业名称:竹溪县子怡鞋店
认证类型:一证
统一社会信用代码:92420324MA4D68J28J
法人姓名:王三华
法人证件号码:420324197711160623

14.会员注册成功通知

请求URL:

  • 通知地址可在核心企业后台配置“开户结果通知地址”参数设置或者通过会员注册邀请码生成接口上送
  • 优先使用会员注册邀请码生成接口上送的通知地址
  • 通过核心企业后台注册默认使用MD5加签;通过会员注册邀请码生成接口注册则使用接口上送签名类型加签

请求方式:

  • POST

请求类型:

  • application/x-www-form-urlencoded

通知参数

参数名

必选

类型

说明

orgId

string

服务商id,有此参数需要用服务商密钥进行验签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若是服务商模式,则为服务商appId

sign

String(32)

签名

signType

String(32)

签名类型 MD5

memAlias

String(50)

会员简称

memCategory

String(2)

会员种类
01-个人
02-企业对公
03-个体工商户

bizUserId

String(2)

商户会员编号

memSubType

String(2)

会员类型
1-收款方
2-分账方

memNo

String(2)

通企付会员编号

phoneNo

String(2)

绑定手机号

memInfo

jsonObject

个人信息
会员种类为“01-个人”返回

enterpriseInfo

jsonObject

企业信息
会员种类为“02-企业对公,03-个体工商户”返回

bankList

jsonArray

绑卡信息

chanList

jsonArray

渠道注册信息

个人信息:

参数名

必选

类型

说明

idenName

String(10)

身份证名称

idenNo

String(18)

身份证号

企业信息:

参数名

必选

类型

说明

companyName

String(50)

企业名称

companyAddress

String(50)

企业地址

authType

String(11)

认证类型 1:三证 2:一证

businessLicense

String(50)

统一社会信用代码或营业执照号

organizationCode

String(50)

组织机构代码,三证时返回

taxRegister

String(50)

纳税人识别号,三证时返回

expLicense

String(50)

营业证件有效期

legalName

String(10)

法人姓名

identityType

String(1)

证件类型 1-身份证

legalIds

String(18)

法人身份证

legalPhone

String(11)

法人手机号

accountNo

String(20)

银行账号

parentBankName

String(20)

开户行名称

bankName

String(20)

开户行支行

unionBank

String(20)

支付行号

legalIdZOCRResult

String(1)

法人证件人像面影印件处理结果 0-待上传 1-识别中 2-识别通过 3-识别失败

legalIdFOCRResult

String(1)

法人证件国徽面影印件处理结果 0-待上传 1-识别中 2-识别通过 3-识别失败

uniCreditOCRResult

String(1)

统一社会信用代码影印件处理结果 0-待上传 1-识别中 2-识别通过 3-识别失败

绑卡信息:

参数名

必选

类型

说明

acctType

String(1)

账户类型 0- 对私 1- 对公

acctNo

String(200)

银行卡号

bankPhoneNo

String(11)

银行卡绑定手机号,账户类型=0-对私,则必填

parentBankName

String(20)

开户行名称

openBankNo

String(10)

银行代码,账户类型=1-对公,则必填

bankName

String(20)

开户行支行名称,账户类型=1-对公,则必填

unionBank

String(20)

支付行号,账户类型=1-对公,则必填

openBankProvince

String(20)

开户行所在省,例 江苏省,上送 江苏

openBankCity

String(20)

开户行所在市,例 南京市,上送 南京

注册渠道信息:

参数名

必选

类型

说明

chanNo

String(10)

渠道编码

chanAuditResult

String(2) 渠道审核状态
2-通过 3-失败
chanAuditResultMsg String(250) 渠道审核失败原因

regState

String(11)

状态
2-正常

返回结果:

业务系统处理后同步返回给支付系统,返回字符串success 则表示成功,返回非success则表示处理失败,支付系统会再次通知。

注意:返回的字符串必须是小写,且前后不能有空格和换行符。

15.会员绑定收银宝商户号开户

接口说明:

  • 通过绑定收银宝商户号注册会员

请求URL:

  • /payMember/regBindSybCusId

请求方式:

  • POST

请求类型:

  • application /json

参数:

参数名

必选

类型

说明

orgId

string

服务商id,用于服务商代发起交易,传了此参数需要用服务商密钥进行加签

mchNo

String(30)

商户号

appId

String(24)

默认为企业appId,若为服务商模式,需传入服务商appId

reqTime

String(13)

请求时间,13位时间戳

version

String(3)

接口版本,固定:1.0

sign

String(32)

签名

signType

String(32)

签名类型,MD5/RSA/SM2

memSubType

String(1)

会员角色:1-收款方
chanNo为yunst2isv时必填

memRole

String(11)

会员角色:
收款方:经销商
chanNo为yunst2isv时必填

bizUserId

String(30)

商户会员编号

chanNo

String(10)

渠道 云商通二代isv:yunst2isv

memAlias

String(50)

会员简称

serialNo

String(32)

请求流水号

sybCusId

String(32)

收银宝商户号

isCoupon

String(1)

是否抽佣,1-是-0-否
chanNo为yunst2isv时必填

返回参数

参数名

必选

类型

说明

code

int

返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段

msg

String(128)

返回信息:具体错误原因,例如:签名失败、参数格式校验错误

sign

String(32)

签名信息:对data内数据签名,如data为空则不返回

data

Json

返回数据:json格式数据

data数据格式

参数名

必选

类型

说明

bizUserId

String(30)

会员编号


秦多荣qindr 2026年4月23日 16:34 收藏文档