测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1024
功能说明:
(1)前提条件:个人会员/企业会员状态=有效;
(2)在POS/当面付/付款码支付前需完成绑定,消费及担保消费订单创建时校验收款是否绑定收银宝商户,未绑定不允许交易收款。
(3)绑定时收银宝商户与会员的主体/平台主体一致性,一致则绑定成功,否则绑定失败;
(4)“账后结算”资金管理模式下,一个会员只能绑定一个收银宝商户号;
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
要求商户系统唯一 |
signNum |
String |
60 |
是 |
商户会员编号 |
|
memberRole |
String |
60 |
否 |
会员角色 |
(1)未注册/未实名,必须上送角色 (2)已实名,无需上送,上送则需要与设置的角色一致 |
opType |
String |
8 |
是 |
操作类型 |
set-绑定收银宝商户 query-查询 |
sybMerchantCode |
String |
20 |
否 |
收银宝商户号 |
set-绑定收银宝商户,必填 |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
40 |
否 |
响应流水号 |
业务正常处理,则返回 |
signNum |
String |
60 |
否 |
商户会员编号 |
|
respCode |
String |
5 |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
失败原因 |
|
sybMerchantCodeArray |
String |
否 |
已绑定收银宝商户列表 |
操作类型=查询,返回,无绑定信息,则返回空数组,详细
|
查询绑定收银宝商户JSON(sybMerchantCodeArray)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
sybMerchantCode |
String |
是 |
收银宝商户号 |
代理商模式:代理商下收银宝子商户号 集团模式:收银宝子商户号 |
bindTime |
String |
是 |
绑定时间 |
YYYY-MM-dd HH:mm:ss |