4.2 领券接口
请求URL:
测试环境: https://mkt-test.allinpay.com/gateapi/mpm/cpmake
生产环境: https://mkt.allinpay.com/gateapi/mpm/cpmake
请求path: /gateapi/mpm/cpmake
请求入参:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
appid |
应用id |
String[10] |
是 |
基础营销平台分配,与报文头一致 |
|
opeid |
活动发起方id |
String[10] |
是 |
由基础营销平台导入，buttid opeid不能同时为空 |
|
tplid |
券模版id |
String[10] |
是 |
券模版id |
|
userid |
用户id |
String[32] |
否 |
用户id和第三方账号必填其一 建议使用userid |
|
cpamt |
券面额 |
Long |
否 |
单位：分；券模板类型为礼品卡且setamt_when_make为1时不能为空，值要大于0且小于等于礼品卡券面额 |
|
acctno |
第三方帐号 |
String[32] |
否 |
例如微信openid，支付宝userid |
|
acct_nature |
帐号属性 |
String[16] |
否 |
wx:微信openid zfb:支付宝userid mobile:手机号码 |
|
notify_url |
通知地址 |
String[256] |
否 |
|
|
out_cpid |
外部流水号 |
String[32] |
是 |
|
返回参数:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
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 |
|
valid_begin |
券可用时间 |
String[14] |
是 |
yyyyMMddHHmmss |
|
valid_end |
券可用时间 |
String[14] |
是 |
yyyyMMddHHmmss |
|
state |
状态 |
String[16] |
是 |
WAITUSE-待使用 USED-已使用 INVALID-已作废 |
|
create_time |
领券时间 |
String[14] |
是 |
yyyyMMddHHmmss |