视频号本地生活
接口列表
撤销用户已核销团购优惠

撤销用户已核销团购优惠

⚠️

-用户核销成功后、资金结算前可撤销核销，撤销时如券仍在有效期内，券变为【待使用】用户可再次使用；如撤销时券已过有效期，券变为【已过期】，触发过期自动退款；
-核销成功后，如资金已结算，不支持撤销核销；
-核销成功后，到达资金结算时间点，平台将自动发起分账，按照技术服务费率、佣金率等计算并分账至对应账户；

如撤销时接口返回“存在券无法执行此操作”失败，表明券为锁定状态（通常为核销处理中）。商家遇此情况可间隔1秒重试一次。如多次重试仍失败，则需要查询券信息、判断券状态是否符合撤销核销条件（券状态为已核销，如已核销仍不能撤销成功，则可能过了资金结算时间点）。

接口调用请求说明
单商户限频200QPS

接口说明

请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/pay/ec/voucher/revoke

请求参数

Request
Body 包体
RevokeRequestNo必填
string

撤销操作幂等串，商户自定义，请保证在小店下唯一

RevokeVouchers必填
array

待撤回核销的券列表，最多10张，需要属于同一个订单，不能为空。 对于次卡类型商品，如果传多个相同的ReovkeVoucher，代表撤销多次。 撤销核销多次/多张同时成功或同时失败，不会部分成功。

数组子类型：object

ConsumeRequestNo选填
string

撤销核销次卡时必须要传此字段，说明撤销的核销单号。

ChannelSubMerchantId必填
string

核销券的商户号（CM开头）

请求示例

{
  "ChannelSubMerchantId": "CM123",
  "RevokeRequestNo": "233244dfgfdfgsdfgsdf",
  "RevokeVouchers": [
    {
      "Code": "123412"
    },
    {
      "Code": "2235"
    }
  ]
}

返回参数

Response
Response选填
object

返回示例

{
  "Response": {
    "RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
    "Result": {
      "voucher_list": [
        {
          "Code": "123412",
          "Status": 1,
          "SendTime": "2023-11-13T14:16:22+08:00",
          "UpdateTime": "2023-11-13T14:16:22+08:00",
          "StartTime": "2023-11-13T14:16:22+08:00",
          "EndTime": "2023-11-13T14:16:22+08:00",
          "ConsumeTime": "2023-11-13T14:16:22+08:00",
          "RefundTime": "2023-11-13T14:16:22+08:00",
          "ProductId": "kbfff",
          "ConsumeStoreName": "xxx旗舰店",
          "VoucherType": 1,
          "VoucherBuyAmount": 0,
          "VoucherActualAmount": 0,
          "TelphoneNo": "fasdf343df34545",
          "Openid": "xsdfs4534543534534",
          "CodeType": 1,
          "OrderId": "23434sdfsdf34342",
          "SkuId": "fdsfdf"
        },
        {
          "Code": "2235",
          "Status": 1,
          "SendTime": "2023-11-13T14:16:22+08:00",
          "UpdateTime": "2023-11-13T14:16:22+08:00",
          "StartTime": "2023-11-13T14:16:22+08:00",
          "EndTime": "2023-11-13T14:16:22+08:00",
          "ConsumeTime": "2023-11-13T14:16:22+08:00",
          "RefundTime": "2023-11-13T14:16:22+08:00",
          "ProductId": "kbfff",
          "ConsumeStoreName": "xxx旗舰店",
          "VoucherType": 1,
          "VoucherBuyAmount": 0,
          "VoucherActualAmount": 0,
          "TelphoneNo": "fasdf343df34545",
          "Openid": "xsdfs4534543534534",
          "CodeType": 1,
          "OrderId": "23434sdfsdf34342",
          "SkuId": "fdsfdf"
        },
        {
          "Code": "32434454545",
          "Status": 1,
          "SendTime": "2023-11-13T14:16:22+08:00",
          "UpdateTime": "2023-11-13T14:16:22+08:00",
          "StartTime": "2023-11-13T14:16:22+08:00",
          "EndTime": "2023-11-13T14:16:22+08:00",
          "ConsumeTime": "2023-11-13T14:16:22+08:00",
          "RefundTime": "2023-11-13T14:16:22+08:00",
          "ProductId": "kbfff",
          "ConsumeStoreName": "xxx旗舰店",
          "VoucherType": 1,
          "VoucherBuyAmount": 0,
          "VoucherActualAmount": 0,
          "TelphoneNo": "fasdf343df34545",
          "Openid": "xsdfs4534543534534",
          "CodeType": 1,
          "OrderId": "23434sdfsdf34342",
          "SkuId": "fdsfdf"
        }
      ]
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}
腾讯云商付接口文档