Coupang Developer Center

Available buyer market: Korea

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/items

Request 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.

[Instant Discount Coupon] Item Addition

Summary

Details