测试地址：http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址：https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码（transCode）：1024
功能说明：
支持“账后结算”模式的应用和非“账后结算”模式的应用进行会员绑定收银宝商户。
|
场景 |
非“账后结算”模式 |
账后结算模式 |
|
前提条件 |
个人会员/企业会员已实名，会员状态=有效 |
个人会员/企业会员未注册或未实名， |
|
主体一致性核对 |
收银宝商户与会员的主体/平台主体一致性，一致则绑定成功，否则绑定失败 |
根据收银宝商户信息自动创建会员，实现会员注册、设置角色、实名，开通待结算户，并与其绑定，默认收银宝商户与会员主体一致 |
|
标签校验 |
收银宝商户已打标签 |
不校验是否打标签 |
|
账户类型 |
薄记账户 |
待结算户 |
|
交易场景 |
用于线下收款场景中：POS/当面付/付款码支付前需完成绑定，消费及担保消费订单创建时校验收款是否绑定收银宝商户，未绑定不允许交易收款 |
将存量收银宝商户与收款会员绑定，用于后续收款、分账 |
|
会员与收银宝商户关系 |
持一个会员绑定多个收银宝商户号，支持一个收银宝商户被多个会员绑定 |
一个收银宝商户绑定一个会员 |
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
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 |