You can use this API to apply the coupon that has been created to the individual items. Being asynchronous, it only processes requests. To see the results, call a different API that is used to check request status, using the "requestedId" value that has been returned in the response.
Path
POST/v2/providers/fms/apis/api/v1/vendors/{vendorId}/coupons/{couponId}/items
Example Endpoint
https://api-gateway.coupang.com/v2/providers/fms/apis/api/v1/vendors/A00012345/coupons/68/itemsRequest Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
Seller ID
Unique code issued by Coupang for each seller
e.g. A00012345
|
||||
| couponId | O | Number |
Coupon ID you want to apply to the given item
|
||||
Body Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorItems | O | Array |
Item ID to which you want to apply the coupon
The maximum number of Item ID's you can upload each time is 10,000.
|
||||
Request Example
{
"vendorItems": [
3226138951,
3226138847
]
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number |
server response code
|
||||
| message | String |
server response message
|
||||
| httpStatus | Number |
HTTP status code (same value as the server response code)
|
||||
| httpStatusMessage | String |
HTTP status message (same value as the server response message)
|
||||
| errorMessage | String |
It details the reason for error except for "http status 200"
|
||||
| data | Object |
Data that shows whether the request succeeded or not
|
||||
| success | Boolean |
true or false
|
||||
| content | Object |
Data about the requested ID for which you want to check status
|
||||
| requestedId | String |
The id you want to query the request status for
e.g. 1542675975663862164
|
||||
| success | Boolean |
true or false
|
||||
| Pagination | Array |
no pagination
|
||||
Response Example
{
"code": 200,
"message": "OK",
"httpStatus": 200,
"httpStatusMessage": "OK",
"errorMessage": "",
"data": {
"success": true,
"content": {
"requestedId": "17258005702255081464",
"success": true
},
"pagination": null
}
}Error Spec
| HTTP Status Code (Error Code) | Error Message | Solution |
|---|---|---|
| 400 (check parameter requested) | vendorItems may not be empty, vendorItems size must be between 1 and 10000 |
See if there are any issues with the vendor item ids you have entered. Please note that you cannot add more than 10,000 item id's at a time. |
| 400 (check parameter requested) | Please check if you're authorized for the vendor | See if the VendorID is correct. |
| 400 (check parameter requested) | Please check CouponID 208463**** | See if the CouponID is correct. |