[다운로드쿠폰] 파기

KRTW

# 01

요약

[다운로드쿠폰] 파기

# 02

상세

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

생성된 다운로드 쿠폰을 파기(만료)합니다.
실제 API 수행 결과값은 응답으로 받은 "requestTransactionId"를 이용하여 '다운로드 쿠폰 요청상태 확인 API'를 조회하면 확인 가능합니다

경로

POST/v2/providers/marketplace_openapi/apis/api/v1/coupons/expire

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupons/expire

URL API Name

EXPIRE_COUPONS

# 03

요청 본문

요청 파라미터

본문 파라미터

Name	Type	Description
expireCouponList*	object[]	다운로드 쿠폰 파기를 위한 데이터
couponId expireCouponList[].couponId	string	쿠폰ID 쿠폰생성 Response에서 확인 가능
reason expireCouponList[].reason	string	expired 입력
userId expireCouponList[].userId	string	사용자 계정 (WING 로그인 ID)

요청 예시application/json

{
  "expireCouponList": [
    {
      "couponId": "16513129",
      "reason": "expired",
      "userId": "testId123"
    }
  ]
}

# 04

응답 본문

Response Example

[
  {
    "requestResultStatus": "SUCCESS",
    "body": {
      "couponId": 16513129,
      "requestTransactionId": "et5_165131291561017478962"
    },
    "errorCode": null,
    "errorMessage": null
  }
]

# 05

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request

오류 사양

HTTP	유형	오류 메시지	해결 방법
500	500 (요청변수확인)	expire할 쿠폰이 존재하지 않습니다.	쿠폰ID(couponId) 값을 올바로 입력했는지 확인합니다.