4.10 远端模式权益查询接口
接口说明：
商户权益核销模式下，通联当面付核销时需要调用此接口查询权益。
商户提供接口供基础营销调用
请求URL:
商户提供接口供基础营销调用
请求入参:
|
参数 |
参数名 |
类型 |
必填 |
描述 |
|
appid |
应用id |
String[10] |
是 |
基础营销平台分配 |
|
opeid |
活动发起方id |
String[10] |
是 |
由基础营销平台分配 |
|
encrypt_type |
加密方式 |
String[16] |
是 |
SM2 |
|
out_userid |
商户用户号 |
String[32] |
是 |
商户平台自己的用户号或者会员号。 |
|
userid |
基础营销平台用户号 |
String[32] |
否 |
|
|
agentid |
代理商编号 |
String[32] |
否 |
|
|
cusid |
商户号 |
String[32] |
是 |
|
|
branchno |
门店号 |
String[32] |
否 |
|
|
native_amt |
原始订单金额 |
long |
是 |
订单的原始金额 |
|
pid |
产品类型 |
String[16]
|
是 |
P0002-当面付 P0003-网上收银 |
|
acct_list |
帐号列表 |
Array[AcctInfo] |
否 |
交易帐号列表 含银行卡帐号、微信帐号、支付宝帐号等第三方帐号 |
其中AcctInfo字段如下
|
参数 |
参数名 |
类型 |
必填 |
描述 |
|
acct_no |
交易帐号 |
String(32) |
是 |
加密传输 |
|
acct_nature |
帐号属性 |
String(16) |
是 |
wx-微信openid wxunion-微信unionid zfb-支付宝userid mobile-手机号码 bank-银行卡号
|
|
acct_bank |
银行编码 |
String(16)
|
否 |
当帐号属性为bank的时候，此字段生效 |
|
acct_type |
账号类型 |
String(16)
|
否 |
00:借记卡 02:信用卡 当帐号属性为bank的时候，此字段生效 |
返回参数:
|
参数 |
参数名 |
类型 |
必填 |
描述 |
|
ret_code |
接口状态码 |
String(4) |
是 |
200-处理成功 详见附录 |
|
ret_msg |
接口错误信息 |
String |
是 |
|
|
result_code |
错误码 |
String(32) |
否 |
SUCCESS-调用成功 详见附录 |
|
result_msg |
错误信息 |
String |
否 |
|
|
encrypt_type |
加密方式 |
String[16] |
是 |
SM4 |
|
cp_list |
优惠券信息列表 |
List<CpInfo> |
否 |
预留，后续启用 |
|
dcinfo_list |
交易立减信息列表 |
List<DcAcctInfo> |
否 |
|
|
giftinfo_list |
礼品卡信息列表 |
List<GiftInfo> |
否 |
预留，后续启用 |
其中DcAcctInfo字段如下
|
参数 |
参数名 |
类型 |
必填 |
描述 |
|
acct_no |
交易帐号 |
String(32) |
是 |
加密传输 |
|
acct_nature |
帐号属性 |
String(16) |
是 |
wx-微信openid wxunion-微信unionid zfb-支付宝userid mobile-手机号码 bank-银行卡号
|
|
dc_match_list |
交易立减信息列表 |
List<DcMatchInfo> |
否 |
|
其中DcMatchInfo字段如下
|
参数 |
参数名 |
类型 |
必填 |
描述 |
|
actid |
活动id |
String[10] |
是 |
基础营销平台的营销活动id |
|
remark |
业务备注字段 |
String(256) |
否 |
核销和核销结果通知会透传，可用于商户平台个性化处理。 |
|
use_amt |
权益核销金额 |
Long
|
是 |
本规则下计算出来的实际核销金额 如果是随机立减，则为0 |
|
range_low |
最低消费金额 |
Long
|
是 |
|
|
dc_high |
最高消费金额 |
Long
|
否 |
预留 |
|
rule_type |
权益类型 |
Int |
是 |
0-固定金额 1-折扣 9-随机立减
|
|
dc_value |
权益数值 |
Long |
是 |
如果是固定金额，dc_value= use_amt 如果是折扣，dc_value为折扣值，例如9折此处填90 如果是随机立减 |