[可下载优惠券]过期/终止

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

将优惠券过期（终止）。 

实际API执行结果可以通过响应的"requestTransactionId"，搜索“满减优惠券请求状态确认API”查看。

路径

POST

/v2/providers/marketplace_openapi/apis/api/v1/coupons/expire

示例

https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupons/expire

请求体参数

Name		Required	Type	Description
expireCouponList		O	Array	销毁满减优惠券时使用的数据
	couponId		Integer	优惠券ID  可在优惠券创建response中查看
	reason		String	输入expired
	userId		String	用户账户 (WING ID)

请求体示例

{  
   "expireCouponList":[  
      {  
         "couponId":"16513129",
         "reason":"expired",
         "userId":"testId123"
      }
   ]
}

返回消息

Name		Type	Description
requestResultStatus		String	调用结果  SUCCESS / FAIL
body		Object
	couponId	Long	优惠券ID  可在优惠券创建response中查看
	requestTransactionId	String	确认调用结果的token值
errorCode		String	发生的错误类型
errorMessage		String	错误详细信息

返回消息示例

[
  {
    "requestResultStatus": "SUCCESS",
    "body": {
      "couponId": 16513129,
      "requestTransactionId": "et5_165131291561017478962"
    },
    "errorCode": null,
    "errorMessage": null
  }
]

错误信息

HTTP Status  Code (Error  Type)	Error Message	Solution
500 (Check  Parameter  Requested)	无即将失效的优惠券。	查看优惠券ID（couponid）是否输入正确。

接口名称

EXPIRE_COUPONS