请求URL:
测试环境: https://mkt-test.allinpay.com/gateapi/mpm/chnlcpmake
生产环境: https://mkt.allinpay.com/gateapi/mpm/chnlcpmake
请求path: /gateapi/mpm/chnlcpmake
请求入参:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
appid |
应用id |
String[10] |
是 |
基础营销平台分配,与报文头一致 |
|
opeid |
活动发起方id |
String[10] |
是 |
由基础营销平台导入，buttid opeid不能同时为空 |
|
tplid |
券模版id |
String[10] |
是 |
券模版id |
|
userid |
用户id |
String[32] |
否 |
用户id和第三方账号必填其一 建议使用userid |
|
acctno |
第三方帐号 |
String[32] |
否 |
例如微信openid，支付宝userid |
|
acct_nature |
帐号属性 |
String[16] |
否 |
wx:微信openid zfb:支付宝userid mobile:手机号码 |
|
wxappid |
微信appid |
String[16] |
否 |
当userid为空且acct_nature为wx时 必填 |
|
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 |
|
chnl_cpid |
渠道券id |
String[32] |
否 |
渠道端的券id 例如微信券id |
|
chnl_tpld |
渠道券模版编号 |
String[32] |
否 |
渠道券的模版id 例如微信券的微信批次号 |
|
valid_begin |
券可用时间 |
String[14] |
是 |
yyyyMMddHHmmss |
|
valid_end |
券可用时间 |
String[14] |
是 |
yyyyMMddHHmmss |
|
state |
状态 |
String[16] |
是 |
WAITUSE-待使用 USED-已使用 INVALID-已作废 |
|
create_time |
领券时间 |
String[14] |
是 |
yyyyMMddHHmmss |