coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산CGF / CGF liteRocket Growth
GET/v2/providers/marketplace_openapi/apis/api/v1/coupons/transactionStatus2609170000

[다운로드쿠폰] 요청상태 확인

KRTW
# 01

요약

[다운로드쿠폰] 요청상태 확인

# 02

상세

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

requestTransactionId 이용하여 쿠폰아이템 생성 API 요청 결과를 확인합니다.

경로

GET/v2/providers/marketplace_openapi/apis/api/v1/coupons/transactionStatus

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/marketplace_openapi/apis/api/v1/coupons/transactionStatus?requestTransactionId=et5_154210571558673553106

URL API Name

GET_REQUEST_STATUS_BY_TRANSACTION_ID
# 03

Query 파라미터

NameTypeDescription
requestTransactionId*number
결과를 조회할 ID
# 04

응답 본문

응답 메시지

NameTypeDescription
transactionStatusResponseobject
호출응답 상세
type
transactionStatusResponse.type
string
상태 확인 대상 API
total
transactionStatusResponse.total
integer
요청 vendoritem 수
succeeded
transactionStatusResponse.succeeded
integer
호출 성공 vendoritem 수
status
transactionStatusResponse.status
string
호출 결과
requestedId
transactionStatusResponse.requestedId
string
응답 조회 Key
couponFailedVendorItemIdResponses
transactionStatusResponse.couponFailedVendorItemIdResponses
object[]
등록실패 vendoritemId 상세 사유
vendorItemId
transactionStatusResponse.couponFailedVendorItemIdResponses[].vendorItemId
integer
API 호출에 사용한 옵션ID
failureReason
transactionStatusResponse.couponFailedVendorItemIdResponses[].failureReason
string
호출 실패 사유
failed
transactionStatusResponse.failed
integer
호출 실패 vendoritem 수
couponId
transactionStatusResponse.couponId
integer
해당 쿠폰ID

Response Example

{
  "transactionStatusResponse": {
    "type": "COUPON_ITEM_PUBLISH",
    "total": 1,
    "succeeded": 0,
    "status": "FAIL",
    "requestedId": "et5_154210571558673553106",
    "couponFailedVendorItemIdResponses": [
      {
        "vendorItemId": 4712512759,
        "failureReason": "[CIR14] 해당 옵션은 이미 다른 쿠폰(14434486 외 2건)에 발행되어져 있습니다."
      }
    ],
    "failed": 1,
    "couponId": 15421057
  }
}
# 05

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

HTTP유형오류 메시지해결 방법
500500 (요청변수확인)

시스템 오류

requestTransactionId 값을 올바로 입력했는지 확인합니다.