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 |