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 |
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] |
否 |
|