4.11 远端模式权益核销接口


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)

结果通知会原样带上


陈佳锴chenjk3 2025年4月11日 16:58 收藏文档