4.4 券状态查询接口
请求URL:
测试环境: https://mkt-test.allinpay.com/mngapi/mng/cpinfo
生产环境: https://mkt.allinpay.com/mngapi/mng/cpinfo
请求path: /mngapi/mng/cpinfo
请求入参:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
appid |
应用id |
String[10] |
是 |
基础营销平台分配,与报文头一致 |
|
opeid |
活动发起方id |
String[10] |
是 |
由基础营销平台导入，buttid opeid不能同时为空 |
|
cpid |
券id |
String[32] |
是 |
券id |
返回参数:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
ret_code |
接口状态码 |
String[4] |
是 |
200-处理成功 详见附录 |
|
ret_msg |
接口错误信息 |
String |
是 |
|
|
result_code |
错误码 |
String[32] |
否 |
SUCCESS-调用成功 详见附录 |
|
result_msg |
错误信息 |
String |
否 |
|
|
appid |
应用id |
String[10] |
是 |
基础营销平台分配,与报文头一致 |
|
cpid |
券id |
String[32] |
是 |
券id |
|
cp_type |
卡券类型 |
String[4] |
是 |
DJQ:优惠券 |
|
tplid |
券模版id |
String[10] |
是 |
券模版id |
|
valid_begin |
券可用时间 |
String[14] |
是 |
yyyyMMddHHmmss |
|
valid_end |
券可用时间 |
String[14] |
是 |
yyyyMMddHHmmss |
|
state |
状态 |
String[16] |
是 |
WAITUSE-待使用 USED-已使用 INVALID-已作废 |
|
create_time |
领券时间 |
String[14] |
是 |
yyyyMMddHHmmss |
|
use_time |
最近一次核销时间 |
String[14] |
否 |
yyyyMMddHHmmss |
|
use_amt |
累计核销金额/次数 |
long |
否 |
单位：分 活动性质为优惠券时，指券抵扣的金额 |
|
native_amt |
最近一次核销原始订单金额 |
long |
否 |
单位：分 |
|
cusid |
最近一次核销商户号 |
String[32] |
否 |
|
|
branchno |
最近一次核销门店号 |
String[32] |
否 |
|
|
trxid |
最近一次核销交易单号 |
String[32] |
否 |
|