5.2用户权益匹配接口
接口地址：
生产环境：https://vsp.allinpay.com/apiweb/mkt/matchmkt
测试环境：https://syb-test.allinpay.com/apiweb/mkt/matchmkt
接口说明：
交易支付前，商户系统可调用本接口查询用户在此订单下可用的权益信息
请求方式:POST
请求参数：
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填12 |
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
用于签名 |
|
opeid |
基础营销运营方id |
基础营销分配的opeid |
否 |
16 |
|
|
mkt_appid |
基础营销appid |
基础营销分配的appid |
否 |
16 |
|
|
userid |
基础营销userid |
是 |
16 |
||
|
out_userid |
商户平台会员编号 |
远端核销模式必填 |
是 |
32 |
|
|
third_user_info |
第三方用户信息 |
Object【ThirdUserInfo】的json字符串 第三方的用户编号 例如微信openid、支付宝userid |
是 |
- |
|
|
trxamt |
交易金额 |
单位分 |
否 |
||
|
branchno |
门店号 |
如果是门店交易，可上送门店号 |
是 |
||
|
pid |
产品类型 |
通联收银宝的产品类型编号 |
是 |
||
|
tpact_info |
交易帐号信息 |
如果商户需要同时匹配该用户不同交易类型的权益，可上送帐号信息 Array【Tpactinfo】的json字符串 |
是 |
||
|
signtype |
签名方式 |
枚举值： RSA RSA2 SM2 |
否 |
8 |
|
|
sign |
签名 |
否 |
-- |
详见收银宝签名规范 |
响应参数：
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS-请求成功 FAIL-请求失败 SYSTEMERR-系统处理异常，请发起查询 PARAMERR-参数错误 SIGNAUTHERR-签名失败 |
否 |
16 |
此字段是通信标识，非交易结果 |
|
retmsg |
返回码说明 |
可 |
100 |
||
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的APPID |
否 |
8 |
|
|
userid |
基础营销userid |
可 |
16 |
||
|
coupon_list |
可用券列表 |
可 |
- |
||
|
uncoupon_list |
不可用券列表 |
可 |
32 |
||
|
giftcp_list |
礼品卡列表 |
可 |
100 |
||
|
ungiftcp_list |
不可用礼品卡列表 |
可 |
|||
|
dcinfo |
立减信息 |
可 |
|||
|
sign |
签名 |
否 |
32 |
||