商品 API 品类 API 品牌 API 运输 / 订单 API 退货 API 换货 API 促销 / 优惠券物流信息客服 / 咨询结算 CGF / CGF lite Rocket Growth

促销 / 优惠券

PUT/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}2609170000

[立减优惠券] 过期/禁用

# 01

简介

[立减优惠券] 过期/禁用

# 02

详细内容

API支持的买家用户地区：韩国

该API用于过期/禁用已创建的优惠券。因以异步方式，仅执行处理请求，

可使用响应的”requestedId” 值，通过确认请求状态API来查看实际API 执行结果值。

在过期/禁用优惠券时，如果该优惠券还有其它未完成请求，则可能导致失败。例如，在创建优惠券后申请添加商品，在完成所有商品添加之前，优惠券的过期/禁用请求将失败。（"success"：输出false）

路径

PUT/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}

示例端点

https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/A00012345/coupons/684245?action=expire

# 03

Path 参数

Name	Type	Description
vendorId*	string	卖家ID 酷澎分配给卖家的固有代码 ex) A00012345
couponId*	number	销毁的优惠券ID

# 04

Query 参数

Name	Type	Description
action*	string	失效

# 05

响应体

响应消息

Name	Type	Description
code	integer	服务器响应代码
message	string	服务器响应信息
httpStatus	integer	HTTP
httpStatusMessage	string	HTTP 状态信息 (与服务器响应信息的值相同)
errorMessage	string	除HTTP Status 200以外，剩下Status 中包含服务器详细失败原因信息
data	object	执行成功与否的数据
success data.success	boolean	成功与否 true or false
content data.content	object	可查看处理状态的请求ID数据
requestedId data.content.requestedId	string	查看处理状态的请求ID ex) 1542675975663862164
success data.content.success	boolean	成功与否 true or false

Response Example

{
  "code": 200,
  "message": "OK",
  "httpStatus": 200,
  "httpStatusMessage": "OK",
  "errorMessage": "",
  "data": {
    "success": true,
    "content": {
      "requestedId": "649102321051192483",
      "success": true
    },
    "pagination": null
  }
}

# 06

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
400	400（确认请求参数）	找不到该优惠券。2325***23	查看输入的优惠券ID（couponId）是否正确。