Available buyer market: Korea
You may use this API to apply downloadable coupons created to vendorItemId.
Note that coupons that are not added to applicable items will be destroyed.
Path
PUT/v2/providers/marketplace_openapi/apis/api/v1/coupon-items
Example Endpoint
https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupon-itemsRequest Parameters
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| couponItems | O | Array |
Data to apply coupon to product
|
||||
| couponId | Number |
Coupon ID
Available in the coupon creation response
|
|||||
| userId | String |
User account (WING login ID)
|
|||||
| vendorItemIds | Array |
OptionID(s) to which to apply coupon
The maximum number of Item ID's you can upload each time is 100.
|
|||||
Request Example
{
"couponItems": [
{
"couponId": "15350660",
"userId": "testaccount1",
"vendorItemIds": [
2306264997,
4802314648,
4230264914
]
}
]
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| requestResultStatus | String |
Result of call
SUCCESS / FAIL
|
||||
| body | Object |
|
||||
| couponId | Integer |
Applicable coupon ID
|
||||
| errorCode | String |
Categorization of errors that occur
|
||||
| errorMessage | String |
Details of error
|
||||
Response Example
{
"requestResultStatus": "SUCCESS",
"body": {
"couponId": 15350660
},
"errorCode": null,
"errorMessage": null
}Error Spec
|
HTTP Status Code (Error type) |
Error message |
Solution |
|---|---|---|
|
400 (Check request parameter) |
This promotion has been deleted. |
Check if you entered couponID correctly. Also check if couponID was deleted because coupon was not applied to option. |
URL API Name
Add_VENDOR_ITEMS_TO_COUPON