将优惠券过期（终止）。
实际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