문의

상품 문의 목록 조회

get

가맹점의 상품 문의 목록을 조회합니다.

사용처

• 고객이 등록한 상품 문의를 조회하고 관리할 수 있습니다

• 문의 상태, 유형, 기간 등으로 필터링하여 조회할 수 있습니다

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageinteger · int32Optional

페이지 번호

Default: 0Example: 0

pageSizeinteger · int32Optional

페이지 크기

Default: 20Example: 20

idsinteger · int64[]Optional

문의 ID 목록

Example: 3,4,10

startDatestring · dateOptional

조회 시작일자 yyyy-MM-dd

Example: 2025-10-01

endDatestring · dateOptional

조회 종료일자 yyyy-MM-dd

Example: 2025-10-31

partnerNamestringOptional

연동 프로그램명 또는 자사 서비스명

Example: 토스쇼핑

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get

/api/v3/shopping-fep/products/inquiries

HTTPcURLJavaScriptPython

GET /api/v3/shopping-fep/products/inquiries HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "totalCount": 150,
    "page": 0,
    "pageSize": 20,
    "hasNext": true,
    "inquiries": [
      {
        "id": 12345,
        "userNo": 98765,
        "gaNo": 11111,
        "merchantUserId": 22222,
        "merchantId": 33333,
        "userName": "홍길동",
        "productId": 44444,
        "productName": "리클라이너",
        "productBadge": "베스트",
        "orderId": 55555,
        "orderedAt": "2026-02-24T21:20:52.490Z",
        "stockOption": "색상: 빨강, 사이즈: L",
        "stockAttributes": [
          [
            {
              "key": "색상",
              "value": "빨강"
            }
          ]
        ],
        "inquiryText": "배송은 언제 되나요?",
        "inquiryStatus": "READY",
        "inquiryType": "상품 문의",
        "inquiryTime": "AFTER_PURCHASE",
        "textType": "INQUIRY",
        "answer": "배송은 3일 이내 완료됩니다.",
        "imageUrls": [
          "https://example.com/image1.jpg",
          "https://example.com/image2.jpg"
        ],
        "createdAt": "2024-11-27T10:55:50+09:00"
      }
    ]
  }
}

상품 문의 답변 등록

post

상품 문의에 대한 답변을 등록합니다.

사용처

• 고객이 등록한 상품 문의에 답변을 작성할 수 있습니다

주의사항

• 답변은 최대 2,000자까지 입력 가능합니다

• productInquiryId는 상품 문의 목록 조회 API에서 확인할 수 있습니다

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

상품 문의 답변 등록 요청

productInquiryIdinteger · int64Required

상품 문의 ID

Example: 12345

answerstring · max: 2000Required

답변 (최대 2,000자)

Example: 배송은 3일 이내 완료 예정입니다. 감사합니다.

partnerNamestringOptional

연동 프로그램명 또는 자사 서비스명

Example: 토스쇼핑

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

성공시 제공, 별도 내용이 없습니다. {}으로 반환

post

/api/v3/shopping-fep/products/inquiries/answer

HTTPcURLJavaScriptPython

POST /api/v3/shopping-fep/products/inquiries/answer HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "productInquiryId": 12345,
  "answer": "배송은 3일 이내 완료 예정입니다. 감사합니다.",
  "partnerName": "토스쇼핑"
}

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {}
}

API 연동 중 문의사항이나 개선 제안이 있으신가요?

토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 연동/개발 문의에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요.