支付券
支付券创建成功后，通过调用此接口激活支付券。 激活支付券接口同步返回请求受理结果，后续通过alipay.marketing.activity.message.created消息接口异步发送激活支付券成功事件消息。 如果成功消息长时间未送达，请联系相关技术人员。
公共请求参数
业务请求参数
activity_id｜活动 id必选string[1,128]
【描述】活动id
【示例值】2016042700826004508401111111
out_biz_no｜外部业务单号必选string[1,64]
【描述】外部业务单号，用作幂等控制。
幂等作用：
参数不变的情况下，再次请求返回与上一次相同的结果。
外部接入方需保证业务单号唯一。
幂等作用：
参数不变的情况下，再次请求返回与上一次相同的结果。
外部接入方需保证业务单号唯一。
【示例值】20170101000001654bb46ba
merchant_access_mode｜商户接入模式必选string[0,32]
【描述】商户接入模式
枚举值
self_mode 商户自接入模式
agency_mode 服务商代接入模式
枚举值
self_mode 商户自接入模式
agency_mode 服务商代接入模式
【枚举值】
商户自接入模式: self_mode
服务商代接入模式: agency_mode
【注意事项】选择服务商代接入模式需配合 app_auth_token 代调用使用
【示例值】self_mode
常见请求示例
推荐示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.activity.voucher.publish&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"activity_id":"2016042700826004508401111111",
"merchant_access_mode":"self_mode",
"out_biz_no":"20170101000001654bb46ba"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
recharge_url｜预充值链接特殊可选string(256)
【描述】预充值链接
限制:
链接有效时间3天
限制:
链接有效时间3天
【注意事项】链接有效时间3天
【示例值】https://voucherprod.alipay.com/coupon/templatepayment.htm?templateid=20210829000730015448005xxoo&authno=2021082910002001170507729xx5&operationid=202x0829x45x35x1170x
响应示例
正常示例
异常示例
{
"alipay_marketing_activity_voucher_publish_response": {
"code": "10000",
"msg": "success",
"recharge_url": "https://voucherprod.alipay.com/coupon/templatepayment.htm?templateid=20210829000730015448005xxoo&authno=2021082910002001170507729xx5&operationid=202x0829x45x35x1170x"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 服务器异常 | 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误参数非法 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试。 |
| biz_error | 业务异常业务异常业务异常活动存在正在进行中的其他操作 | 活动的创建、修改、追加等操作都是异步进行的。因此如在活动修改中时，发出追加操作，会提示活动存在正在进行中的其他操作。 |
| business_has_risk | 当前操作存在风险 | 风控判定当前业务操作存在风险，请稍后再试。如果重试一直失败，请联系凯发app官方网站的技术支持 |