Coupang Developer Center

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

Request 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

[Downloadable Coupon] Item Creation

Summary

Details