4.6立减活动查询接口


4.6立减活动查询接口

接口说明:

请求URL:

测试:https://mkt-test.allinpay.com/mngapi/mng/dcactdetail

生产:https://mkt.allinpay.com/mngapi/mng/dcactdetail

请求入参:

参数

参数名

类型

必填

描述

appid

应用id

String[10]

基础营销平台分配

buttid

对接方id

String[10]

基础营销平台分配

opeid

活动发起方id

String[10]

由基础营销平台导入,buttid opeid不能同时为空

actid

活动id

String[32]

基础营销平台的营销活动id

返回参数:

参数

参数名

类型

必填

描述

ret_code

接口状态码

String(4)

200-处理成功

详见附录

ret_msg

接口错误信息

String

 

result_code

错误码

String(32)

SUCCESS-调用成功

详见附录

result_msg

错误信息

String

 

actid

活动id

String[32]

基础营销平台的营销活动id

outactid

商户平台活动id

String[10]

 

branchid

所属分公司

String[32]

 

act_name

活动名称

String[64]

活动名称

act_desc

活动描述

String[-]

 

act_banner

活动banner

String[-]

 

status

状态

String[8]

WAITCFM-待审核

FAILCFM-审核不通过

RUNNING-投放中

PAUSE-暂停投放

TERMINAL-终止投放

FINISHWO-终止核销

FINAL-完结

act_begin

活动开始时间

String[14]

yyyyMMddHHmmss

act_end

活动结束时间

String[14]

yyyyMMddHHmmss

rule_type

优惠类型

int

0-固定值,1-折扣比例(百分比),9-随机立减

remote_type

核销模式

Integer

0:本地,1:远端

rule_range_low

消费金额

Long

remote_type=0本地模式下生效,单位为分,优惠规则:满x元

rule_dc_value

优惠金额

Long

remote_type=0本地模式下生效,rule_type=0必填,单位为分,优惠规则:立减x元

rule_dc_percent

折扣比例

Long

remote_type=0本地模式下生效,rule_type=1必填,百分比1-99

rule_dc_high

最大优惠金额

Long

remote_type=0本地模式下生效,rule_type=1和rule_type=9必填,单位为分,不能大于1000元

div_rule_list

减价区间

Array[Dcactamtrulerditv]

rule_type=9必填,结构见4.2 Dcactamtrulerditv

limit_acct_pattern

指定卡BIN(非标)

String[200]

remote_type=0本地模式下且选择了快捷支付时有效,正则表达式:\b((卡bin)\d{总长度-卡bin位数})\b。多个卡bin时以| 隔开。

示例:卡BIN为625202,卡号位数16位,正则表达式:\b((625202)\d{10})\b,

多个示例:\b((625202)\d{10})\b|\b((621101)\d{10})\b

limit_acct_cardbin

指定卡BIN(标准卡BIN)

String[1024]

remote_type=0本地模式下且选择了快捷支付时有效,格式:卡BIN + “-” + 卡号长度,多个以逗号分隔

示例:622425-19

多个示例:622425-19,622422-19

limit_woer_type

可用商户类型

int

1:商户

2:代理商

3:门店

limit_pid

产品类型

string

P0002:当面付

P0003:网上收银

默认P0002:当面付

limit_trxcode

交易方式

String

VSP501:微信支付

VSP511: 支付宝支付

VSP301:快捷支付

多个用英文逗号分隔

cus_limit_sumcnt

单商户总笔数限制

Integer

例如单商户总限制X笔,为0或空不限制,不能小于单商户周期内限制笔数

cus_limit_pertype

单商户限制周期类型

String[1]

1:每日

2:每周

3:每月

为空不限制,填入cus_limit_cnt时该字段必填,否则不生效

cus_limit_cnt

单商户周期内笔数限制

Integer

例如单商户每周限制x笔,为0或空不限制,填入cus_limit_pertype后必填

limit_type

限制类型

String[8]

USER:单用户

ACCT:单卡号

为空不限制,传入limit_pertype、limit_cnt、limit_sumcnt时该字段必填,否则不生效

limit_sumcnt

单用户标识总笔数限制

Integer

例如单卡号(ACCT)总限制X笔,为0或空不限制

limit_pertype

单用户标识限制周期类型

String[1]

1:每日

2:每周

3:每月

为空不限制,填入limit_cnt时该字段必填,否则不生效

limit_cnt

单用户标识周期内笔数限制

Integer

例如单卡号(ACCT)每周限制x笔,为0或空不限制,传入limit_pertype后必填

use_conflict

是否和其他同类型权益互斥

integer

0-不互斥,1-互斥,默认1互斥
说明:立减与立减之间的互斥,优惠券/立减/礼品卡不互斥

actamt_plan

预算金额

Long

单位为分

actamt_use

已核销金额

Long

单位为分

funder_list

出资方列表

Array[ActFunder]

结构见4.2 ActFunder

create_time

创建时间

String[14]

yyyyMMddHHmmss


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