终止活动API

商户可通过该接口停止支付有礼活动。

最新更新时间: 2019.11.28 版本说明

接口说明

适用对象: 微信支付商户 服务商 渠道商
请求 URL: https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/{activity_id}/terminate
请求方式: POST
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3

path 指该参数需在请求 URL 传参
query 指该参数需在请求 JSON 传参

请求参数

变量 |类型 |必填 |参数名/描述/示例值

活动 id activity_id string(20) 是 path 活动 id |||10028001

请求示例

URL https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001/terminate

返回参数

变量 |类型 |必填 |参数名/描述/示例值

生效时间 terminate_time string(32) 是 生效时间, 遵循 rfc3339 标准格式, 格式为 YYYY-MM-DDTHH:mm:ss:sss+TIMEZONE, YYYY-MM-DD 表示年月日, T 出现在字符串中, 表示 time 元素的开头, HH:mm:ss:sss 表示时分秒毫秒, TIMEZONE 表示时区(+08:00 表示东八区时间, 领先 UTC 8 小时, 即北京时间）。例如: 2015-05-20T13:29:35.120+08:00 表示, 北京时间 2015 年 5 月 20 日 13 点 29 分 35 秒。 |||2015-05-20T13:29:35.120+08:00 活动 id activity_id string(20) 是 活动 id |||126002309

返回示例

{
  "terminate_time": "2015-05-20T13:29:35.120+08:00",
  "activity_id": "10028001"
}

错误码公共错误码

|状态码 |错误码 |描述| 解决方案 |- 500 SYSTEM_ERROR 系统错误 请使用相同参数稍后重新调用 400 PARAM_ERROR 参数错误 根据错误提示, 传入正确参数 403 NO_AUTH 商户未被授权 登录商户平台核对, 传入正确信息 429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制 400 INVALID_REQUEST 请求参数符合参数格式, 但不符合业务规则 根据错误提示, 传入符合业务规则的参数 400 MCH_NOT_EXISTS 商户号不存在 请确认发券商户号信息是否有误 404 RESOURCE_NOT_EXISTS 资源不存在或无可用 请确认资源均存在且可用 400 APPID_MCHID_NOT_MATCH appid 与 mchid 不匹配 请确认 appid 是否正确填写 401 SIGN_ERROR 签名错误或签名信息不完整 登录商户平台核对, 传入正确信息


最后修改 April 12, 2020: 整理文档 (f36b91e)