4.11 远端模式权益核销接口
接口说明:
商户权益核销模式下,通联当面付核销时需要调用此接口核销权益。
请求URL:
商户提供接口供基础营销调用
请求入参:
参数 |
参数名 |
类型 |
必填 |
描述 |
appid |
应用id |
String[10] |
是 |
基础营销平台分配 |
opeid |
活动发起方id |
String[10] |
是 |
由基础营销平台分配 |
encrypt_type |
加密方式 |
String[16] |
是 |
SM2 |
agentid |
代理商编号 |
String[32] |
否 |
|
cusid |
商户号 |
String[32] |
是 |
|
branchno |
门店号 |
String[32] |
否 |
|
native_amt |
原始订单金额 |
long |
是 |
券关联的原始金额 |
allow_useamtsum_max |
远端可核销金额 |
long |
是 |
如果用户同时选了平台优惠和远端机构优惠,远端可核销金额等于原始订单金额减去平台固定优惠金额。 机构核销时候以此字段为准。 |
out_userid |
商户用户号 |
String[32] |
是 |
|
trxid |
交易单号 |
String[32] |
是 |
|
trxcode |
交易类型 |
String[32] |
是 |
VSP301:快捷支付 VSP501:微信支付 VSP511:支付宝支付 |
acct_info |
交易账户信息 |
AcctInfo |
|
|
dc_use_list |
交易立减信息列表 |
List<DcUseInfo> |
否 |
其中DcUseInfo字段如下
参数 |
参数名 |
类型 |
必填 |
描述 |
actid |
活动id |
String[32] |
是 |
基础营销平台的营销活动id |
remark |
业务备注字段 |
String(256) |
否 |
权益查询上送的业务备注 |
其中Dcinfo字段如下
参数 |
参数名 |
类型 |
必填 |
描述 |
actid |
活动id |
String[32] |
是 |
基础营销平台的营销活动id |
remark |
业务备注字段 |
String(256) |
否 |
权益查询上送的业务备注 |
返回参数:
参数 |
参数名 |
类型 |
必填 |
描述 |
ret_code |
接口状态码 |
String(4) |
是 |
200-处理成功 详见附录 |
ret_msg |
接口错误信息 |
String |
是 |
|
result_code |
错误码 |
String(32) |
否 |
SUCCESS-调用成功 详见附录 |
result_msg |
错误信息 |
String |
否 |
|
dc_result_list |
立减结果 |
List<Dcresult> |
否 |
核销成功必填 |
其中Dcresult字段如下
参数 |
参数名 |
类型 |
必填 |
描述 |
out_dcid |
核销流水id |
String[32] |
是 |
外部核销流水 |
actid |
活动id |
String[32] |
是 |
基础营销平台的营销活动id |
rule_type |
权益类型 |
Int |
是 |
0-固定金额 1-折扣 9-随机立减 |
use_amt |
核销金额 |
long |
是 |
|
remark |
业务备注字段 |
String(256) |
否 |
结果通知会原样带上 |