Coupang Developer Center

API 적용 가능한 구매자 사용자 지역: 한국

옵션상품(vendorItemId)에 생성된 다운로드 쿠폰을 적용하기 위한 API입니다.

상품 추가에 실패하면 해당 쿠폰은 파기됩니다.

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	상품 쿠폰적용을 위한 데이터
	couponId		Number	쿠폰ID 쿠폰생성 Response에서 확인 가능
	userId		String	사용자 계정 (WING 로그인 ID)
	vendorItemIds		Array	쿠폰 적용하고자 하는 옵션ID(s) 한 번에 적용할 옵션ID 수는 100개를 초과할 수 없음

Request Example

{
  "couponItems": [
    {
      "couponId": "15350660",
      "userId": "testaccount1",
      "vendorItemIds": [
        2306264997,
        4802314648,
        4230264914
      ]
    }
  ]
}

Response Message

Name		Type	Description
requestResultStatus		String	호출 결과 SUCCESS / FAIL
body		Object
	couponId	Integer	해당 쿠폰 ID
errorCode		String	에러발생 시 분류
errorMessage		String	에러 상세내용

Response Example

{
  "requestResultStatus": "SUCCESS",
  "body": {
    "couponId": 15350660
  },
  "errorCode": null,
  "errorMessage": null
}

Error Spec

HTTP 상태 코드 (오류 유형)	오류 메시지	해결 방법
400 (요청변수확인)	삭제된 프로모션 입니다.	쿠폰ID(couponId) 값을 올바로 입력했는지 확인합니다. 옵션에 쿠폰 적용이 실패하여 쿠폰ID가 삭제되었는지 확인합니다.

URL API Name

Add_VENDOR_ITEMS_TO_COUPON

[다운로드쿠폰] 아이템 생성

요약

상세