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

# 01

简介

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

# 02

详细内容

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

# 03

请求体参数

请求参数

请求体参数

Name	Type	Description
expireCouponList*	object[]	销毁满减优惠券时使用的数据
couponId expireCouponList[].couponId	string	优惠券ID 可在优惠券创建response中查看
reason expireCouponList[].reason	string	输入expired
userId expireCouponList[].userId	string	用户账户 (WING ID)
body	object
couponId body.couponId	string	优惠券ID 可在优惠券创建response中查看
requestTransactionId body.requestTransactionId	string	确认调用结果的token值
errorCode	string	发生的错误类型
errorMessage	string	错误详细信息
500 (Check Parameter Requested)	string	查看优惠券ID（couponid）是否输入正确。

请求示例application/json

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

# 04

响应体

Response Example

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

# 05

错误码

HTTP	代码	消息
400	HTTP_400	Bad Request

错误说明

HTTP	类型	错误消息	解决方案
500	500 (Check Parameter Requested)	无即将失效的优惠券。	查看优惠券ID（couponid）是否输入正确。