상품

상품 등록

post

상품 등록 API입니다.

주의사항

• 상품 등록/수정 시에는 초당 30건 이하로 요청해주셔야 합니다

• 초과 시에는 이용량 초과로 인해 요청이 실패할 수 있습니다

• 카테고리 제약사항은 주기적으로 수정될 수 있으므로, API를 호출하여 제약사항을 주기적으로 확인 후 기입되도록 구현 부탁드립니다

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

상품 등록 요청

namestringRequired

상품명

• 정규식: ^[0-9a-zA-Z가-힣 ()-·[]/&+,~.*_#]{1,100}$

Example: 리클라이너

brandNamestringOptional

브랜드명

• 정규식: [0-9a-zA-Z가-힣 *()-_+/.,]{1,50}

• 사용 불가 단어: 없음, 중국, 기타, OEM, 협력사

Example: 토스

categoryIdinteger · int64Required

상품 카테고리 ID

• 카테고리 중에 isLeaf=true인 최하위 카테고리ID만 가능

Example: 12345

isTaxFreebooleanRequired

면세 상품 여부

• true: 면세
• false: 과세

Example: false

isCultureDeductionbooleanOptional

문화비 소득공제 적용 여부

Example: false

managementCodestringOptional

판매자가 상품을 관리하려고 사용하는 코드 (최대 100자)

Example: PROD-001

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

post

/api/v3/shopping-fep/products/v2

HTTPcURLJavaScriptPython

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

{
  "name": "리클라이너",
  "brandName": "토스",
  "categoryId": 12345,
  "stocks": [
    {
      "options": [
        {
          "groupName": "색상",
          "valueName": "블랙"
        }
      ],
      "remainingCount": 100,
      "isHide": false,
      "isMainPrice": true,
      "originPrice": 50000,
      "salePrice": 45000,
      "searchOption": {
        "searchOptionWithValue": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "managementCode": "OPT-001",
      "images": [
        {
          "url": "https://picsum.photos/600",
          "order": 0
        }
      ]
    }
  ],
  "images": [
    {
      "type": "THUMBNAIL",
      "productItemId": 67890,
      "url": "https://picsum.photos/600",
      "html": "<div>상품 설명</div>",
      "order": 0
    }
  ],
  "exposure": {
    "searchKeywords": [
      "text"
    ],
    "description": "편안한 리클라이너 의자입니다",
    "serialNumber": "RC-2024-001"
  },
  "isTaxFree": false,
  "deliveryPolicy": {
    "deliveryMethod": "NORMAL",
    "deliveryDeadline": "14:00",
    "preparationDays": 3,
    "deliveryLocationId": 1001,
    "deliveryFeeType": "CONDITIONALLY_FREE",
    "deliveryFee": 3000,
    "minimumPurchasePrice": 50000,
    "isJejuAndIslandsMountainsDelivery": true,
    "jejuDeliveryFee": 5000,
    "islandsMountainsDeliveryFee": 5000,
    "deliveryCompanyId": 1
  },
  "exchangeReturnPolicy": {
    "exchangeRefundLocationId": 2001,
    "refundOneWayDeliveryFee": 3000,
    "exchangeRoundTripDeliveryFee": 6000,
    "applicationMethodDescription": "고객센터를 통해 신청해주세요",
    "applicationTermDescription": "구매 후 7일 이내"
  },
  "notice": {
    "categoryCode": "CLOTHING",
    "items": [
      {
        "id": 101,
        "content": "면 100%"
      }
    ]
  },
  "isCultureDeduction": false,
  "managementCode": "PROD-001",
  "partnerName": "토스쇼핑"
}

200

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

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

상품 정보 변경

put

상품등록시 반환된 상품 ID를 이용하여 상품 정보를 변경합니다.

검수 정책

• 이미지 변경: 검수 단계로 진입됩니다

• 가격/재고/배송정보 변경: 즉시 반영됩니다

• 검수 반려된 상품: 정보 변경 시 자동으로 검수 단계로 진입합니다

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

productIdinteger · int64Required

상품 ID

Example: 111

Body

application/json

상품 정보 변경 요청

namestringRequired

상품명

• 정규식: ^[0-9a-zA-Z가-힣 ()-·[]/&+,~.*_#]{1,100}$

Example: 리클라이너

brandNamestringOptional

브랜드명

• 정규식: [0-9a-zA-Z가-힣 *()-_+/.,]{1,50}

• 사용 불가 단어: 없음, 중국, 기타, OEM, 협력사

Example: 토스

isTaxFreebooleanRequired

면세 상품 여부 (true: 면세, false: 과세)

Example: false

isCultureDeductionbooleanOptional

문화비 소득공제 적용 여부

Example: false

categoryIdinteger · int64Required

상품 카테고리 ID

Example: 1001

managementCodestringOptional

상품 관리 코드 (최대 100자)

Example: PROD-2024-001

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

put

/api/v3/shopping-fep/products/{productId}/v2

HTTPcURLJavaScriptPython

PUT /api/v3/shopping-fep/products/{productId}/v2 HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 980

{
  "name": "리클라이너",
  "brandName": "토스",
  "stocks": [],
  "images": [],
  "exposure": {
    "searchKeywords": [
      "text"
    ],
    "description": "편안한 리클라이너 의자입니다",
    "serialNumber": "RC-2024-001"
  },
  "isTaxFree": false,
  "isCultureDeduction": false,
  "deliveryPolicy": {
    "deliveryMethod": "NORMAL",
    "deliveryDeadline": "14:00",
    "preparationDays": 3,
    "deliveryLocationId": 1001,
    "deliveryFeeType": "CONDITIONALLY_FREE",
    "deliveryFee": 3000,
    "minimumPurchasePrice": 50000,
    "isJejuAndIslandsMountainsDelivery": true,
    "jejuDeliveryFee": 5000,
    "islandsMountainsDeliveryFee": 5000,
    "deliveryCompanyId": 1
  },
  "exchangeReturnPolicy": {
    "exchangeRefundLocationId": 2001,
    "refundOneWayDeliveryFee": 3000,
    "exchangeRoundTripDeliveryFee": 6000,
    "applicationMethodDescription": "고객센터를 통해 신청해주세요",
    "applicationTermDescription": "구매 후 7일 이내"
  },
  "notice": {
    "categoryCode": "CLOTHING",
    "items": [
      {
        "id": 101,
        "content": "면 100%"
      }
    ]
  },
  "categoryId": 1001,
  "managementCode": "PROD-2024-001",
  "partnerName": "토스쇼핑"
}

200

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

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

상품 삭제

post

상품을 삭제합니다.

주의사항

• 노출중인 상품은 삭제할 수 없습니다

• 상품 삭제 전 상품 정보 노출 상태 숨기기로 변경 API를 호출하여 숨김 처리 후 삭제해주셔야 합니다

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

상품 삭제 요청

productIdinteger · int64Required

상품 ID

Example: 111

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

post

/api/v3/shopping-fep/products/remove

HTTPcURLJavaScriptPython

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

{
  "productId": 111,
  "partnerName": "토스쇼핑"
}

200

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

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

상품 조회

get

상품 ID를 이용하여 상품 정보를 조회합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

productIdinteger · int64Required

상품 ID

Example: 12345

Query parameters

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get

/api/v3/shopping-fep/products/{productId}/v2

HTTPcURLJavaScriptPython

GET /api/v3/shopping-fep/products/{productId}/v2 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": {
    "id": 12345,
    "merchantId": 67890,
    "name": "리클라이너",
    "brandName": "토스",
    "originPrice": 100000,
    "salePrice": 80000,
    "isHide": false,
    "isTaxFree": false,
    "isCultureDeduction": false,
    "isFeeRateAgreed": true,
    "inspectionStatus": "COMPLETE",
    "rejectionReasons": [
      {
        "title": "이미지 품질 문제",
        "message": "상품 이미지가 흐릿하거나 불명확합니다."
      }
    ],
    "exposure": {
      "searchKeywords": [
        "text"
      ],
      "description": "편안한 리클라이너 의자입니다",
      "serialNumber": "RC-2024-001"
    },
    "serialNumberId": 101,
    "version": 1,
    "deliveryPolicy": {
      "deliveryType": "NORMAL",
      "deliveryMethod": "NORMAL",
      "deliveryDeadline": "14:00",
      "deliveryCutoffTime": "14:00",
      "preparationDays": 3,
      "deliveryLocationId": 1001,
      "deliveryFeeType": "CONDITIONALLY_FREE",
      "deliveryFee": 3000,
      "minimumPurchasePrice": 50000,
      "isJejuAndIslandsMountainsDelivery": true,
      "jejuDeliveryFee": 5000,
      "islandsMountainsDeliveryFee": 5000,
      "deliveryCompanyId": 1
    },
    "firstCategoryId": 1,
    "firstCategoryName": "가구/인테리어",
    "categoryId": 1001,
    "categoryName": "의자",
    "categories": [
      {
        "id": 1001,
        "level": 2,
        "name": "의자",
        "parentId": 1
      }
    ],
    "options": [
      {
        "name": "색상",
        "order": 0,
        "values": [
          {
            "name": "블랙",
            "order": 0
          }
        ]
      }
    ],
    "stocks": [
      {
        "id": 1001,
        "itemId": 2001,
        "type": "NORMAL",
        "options": [
          {
            "groupName": "색상",
            "valueName": "블랙"
          }
        ],
        "remainingCount": 100,
        "isMainPrice": true,
        "isHide": false,
        "originPrice": 100000,
        "salePrice": 80000,
        "searchOption": [
          {
            "groupName": "크기",
            "valueName": "Large"
          }
        ],
        "managementCode": "OPT-001",
        "representativeThumbnailImage": "https://picsum.photos/600",
        "images": [
          {
            "url": "https://picsum.photos/600"
          }
        ]
      }
    ],
    "images": [
      {
        "type": "THUMBNAIL",
        "url": "https://picsum.photos/600",
        "requestedUrl": "https://picsum.photos/600",
        "sellerHtml": "<img src=https://picsum.photos/600/>",
        "order": 0
      }
    ],
    "exchangeReturnPolicy": {
      "exchangeRefundLocationId": 2001,
      "refundOneWayDeliveryFee": 3000,
      "exchangeRoundTripDeliveryFee": 6000,
      "applicationMethodDescription": "고객센터를 통해 신청해주세요",
      "applicationTermDescription": "구매 후 7일 이내"
    },
    "notice": {
      "categoryCode": "CLOTHING",
      "items": [
        {
          "id": 101,
          "title": "소재",
          "content": "면 100%"
        }
      ]
    },
    "lastInspectionRequestedAt": "2026-02-24T19:35:23.895Z",
    "managementCode": "PROD-2024-001",
    "removedAt": "2026-02-24T19:35:23.895Z"
  }
}

상품 목록 조회

get

등록한 상품 목록을 커서 조회합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

regStartDatestring · dateOptional

상품 등록 일자 시작 범위

Example: 2025-12-10

regEndDatestring · dateOptional

상품 등록 일자 끝 범위

Example: 2025-12-10

productIdsinteger · int64[]Optional

조회할 상품 ID 목록

Example: 1

nextTokenstringOptional

다음 페이지를 위한 커서 정보 (직전 호출에서 받은 nextToken을 그대로 넘겨 호출)

Example: eyJwcm9kdWN0SWQiOjEzNzI0OSwic29ydFZhbHVlcyI6WzEzNzI0OV19

sizeinteger · int32Optional

페이지 사이즈 (기본값: 20)

Default: 20Example: 20

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get

/api/v3/shopping-fep/products/v2

HTTPcURLJavaScriptPython

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

200

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

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "text",
    "reason": "text"
  },
  "success": {
    "products": [
      {
        "id": 12345,
        "images": [
          {
            "id": 67890,
            "type": "THUMBNAIL",
            "url": "https://picsum.photos/600",
            "inspectionStatus": "LLM_INSPECTION_READY",
            "indexOrder": 0
          }
        ],
        "brandName": "토스",
        "name": "리클라이너",
        "salePrice": 80000,
        "inspectionStatus": "COMPLETE",
        "exposureStatus": "EXPOSURE",
        "regTs": "2026-02-24T19:35:23.895Z"
      }
    ],
    "nextToken": "text",
    "hasNext": true
  }
}

상품 정보 노출 상태 보이기로 변경

post

상품의 노출 상태를 '보이기'로 변경합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

상품 보이기 요청

productIdinteger · int64Required

상품 ID

Example: 12345

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

post

/api/v3/shopping-fep/products/show

HTTPcURLJavaScriptPython

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

{
  "productId": 12345,
  "partnerName": "토스쇼핑"
}

200

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

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

상품 정보 노출 상태 숨기기로 변경

post

상품의 노출 상태를 '숨기기'로 변경합니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

상품 숨기기 요청

productIdinteger · int64Required

상품 ID

Example: 12345

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

post

/api/v3/shopping-fep/products/hide

HTTPcURLJavaScriptPython

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

{
  "productId": 12345,
  "partnerName": "토스쇼핑"
}

200

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

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

상품 옵션 판매가 수정

put

특정 상품 옵션의 판매가를 수정합니다.

가격 구조

• 정상가: 권장소비자가격(도서는 정가) 또는 자사몰/온라인 판매 채널에서 판매 이력이 있는 가격

• 판매가: 실제로 소비자에게 상품을 판매하는 가격으로 쿠폰 등의 할인이 포함되지 않은 가격

상품정보 변경 시, API 호출 순서

1. 상품 정보 조회 API로 상품 아이템 ID를 획득

2. 해당 상품 아이템 ID를 활용하여 판매가 수정 API 호출

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

productItemIdinteger · int64Required

상품 아이템 ID (상품 옵션 ID)

Example: 67890

Body

application/json

상품 옵션 판매가 수정 요청

productIdinteger · int64Required

상품 식별용 ID

Example: 12345

salePriceinteger · int32Required

판매가 (셀러가 등록한 가격)

• 최소 1원 이상
• 정상가(originPrice) 이하여야 합니다

Example: 80000

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

put

/api/v3/shopping-fep/product-items/{productItemId}/sale-price

HTTPcURLJavaScriptPython

PUT /api/v3/shopping-fep/product-items/{productItemId}/sale-price HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "productId": 12345,
  "salePrice": 80000,
  "partnerName": "토스쇼핑"
}

200

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

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

상품 옵션 정상가 수정

put

특정 상품 옵션의 정상가를 수정합니다.

가격 구조

• 정상가: 권장소비자가격(도서는 정가) 또는 자사몰/온라인 판매 채널에서 판매 이력이 있는 가격

• 판매가: 실제로 소비자에게 상품을 판매하는 가격으로 쿠폰 등의 할인이 포함되지 않은 가격

상품정보 변경 시, API 호출 순서

1. 상품 정보 조회 API로 상품 아이템 ID를 획득

2. 해당 상품 아이템 ID를 활용하여 정상가 수정 API 호출

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

productItemIdinteger · int64Required

상품 아이템 ID (상품 옵션 ID)

Example: 67890

Body

application/json

상품 옵션 정상가 수정 요청

productIdinteger · int64Required

상품 식별용 ID

Example: 12345

originPriceinteger · int32Required

변경할 정상가 가격

Example: 100000

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

put

/api/v3/shopping-fep/product-items/{productItemId}/origin-price

HTTPcURLJavaScriptPython

PUT /api/v3/shopping-fep/product-items/{productItemId}/origin-price HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "productId": 12345,
  "originPrice": 100000,
  "partnerName": "토스쇼핑"
}

200

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

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

상품 구매 개수 제한 생성

post

특정 상품 또는 옵션에 대한 구매 개수 제한을 생성합니다.

제한 설정

• startTs, endTs: 구매 제한이 적용되는 기간 설정합니다. (ISO-8601 형식)

• maxQuantityPerUser: 기간 내 사용자 1인당 구매 가능한 최대 수량입니다.

• productItemIds: 여러 옵션에 대해 동일한 제한 적용 시 배열로 전달합니다.

주의사항

• 동일한 옵션들은 같은 purchaseLimitGroupId로 묶여서 관리됩니다.

• startTs는 endTs보다 이전이어야 함

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

구매 수량 제한 생성 요청

productIdinteger · int64Required

상품 식별용 ID

• 검수 승인 완료된 상품만 가능

Example: 2001

productItemIdsinteger · int64[]Required

옵션 식별용 ID 목록 (1개 이상 필수)

Example: [1001,1002]

startTsstring · date-timeRequired

시작일자

• 익일 이후만 가능 (당일 및 과거 날짜 불가)

endTsstring · date-timeRequired

종료일자

• 시작일자 이후여야 합니다
• 동일 옵션에 대해 기간이 겹치는 구매 제한이 이미 존재하면 생성 불가

maxQuantityPerUserinteger · int32Required

제한할 구매 갯수 (1 이상의 양수)

Example: 5

partnerNamestringOptional

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

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

post

/api/v3/shopping-fep/purchase-limits

HTTPcURLJavaScriptPython

POST /api/v3/shopping-fep/purchase-limits HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 163

{
  "productId": 2001,
  "productItemIds": [
    1001,
    1002
  ],
  "startTs": "2026-02-24T19:35:23.895Z",
  "endTs": "2026-02-24T19:35:23.895Z",
  "maxQuantityPerUser": 5,
  "partnerName": "text"
}

200

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

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "items": [
      {
        "purchaseLimitGroupId": 100,
        "productId": 2001,
        "productItemId": 1001,
        "maxQuantityPerUser": 5,
        "description": "text",
        "startTs": "2026-02-24T19:35:23.895Z",
        "endTs": "2026-02-24T19:35:23.895Z"
      }
    ]
  }
}

상품 구매 개수 제한 조회

get

특정 상품에 설정된 구매 개수 제한을 조회합니다.

응답 정보

• purchaseLimitGroupId: 동일한 구매 개수 제한 그룹에 속한 옵션들은 같은 ID를 가집니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

productIdinteger · int64Required

Query parameters

partnerNamestringOptional

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

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get

/api/v3/shopping-fep/purchase-limits/product-ids/{productId}

HTTPcURLJavaScriptPython

GET /api/v3/shopping-fep/purchase-limits/product-ids/{productId} 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": {
    "items": [
      {
        "purchaseLimitGroupId": 100,
        "productId": 2001,
        "productItemId": 1001,
        "maxQuantityPerUser": 5,
        "description": "text",
        "startTs": "2026-02-24T19:35:23.895Z",
        "endTs": "2026-02-24T19:35:23.895Z"
      }
    ]
  }
}

상품 구매 개수 제한 제거

delete

설정된 구매 개수 제한을 삭제합니다.

삭제 방법

• purchaseLimitGroupId: 조회 API에서 확인한 구매 개수 제한 그룹 ID입니다.

• productItemId: 삭제할 옵션 ID입니다.

• 여러 옵션의 제한을 한 번에 삭제 가능합니다. (배열로 전달)

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

구매 수량 제한 삭제 요청

partnerNamestringOptional

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

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

delete

/api/v3/shopping-fep/purchase-limits

HTTPcURLJavaScriptPython

DELETE /api/v3/shopping-fep/purchase-limits HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "purchaseLimitGroups": [
    {
      "productItemId": 1001,
      "purchaseLimitGroupId": 100
    }
  ],
  "partnerName": "text"
}

200

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

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

상품 옵션 정상 재고 수량 변경

put

특정 상품 옵션의 정상 재고 수량을 변경합니다.

주의사항

• 재고 수량은 음수가 될 수 없습니다.

• 재고 수량을 0으로 설정하면 품절 처리됩니다.

• 품절 상태의 상품의 재고 수량을 1 이상으로 설정하면 품절 취소됩니다.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

productItemIdinteger · int64Required

상품 아이템 ID (상품 옵션 ID)

Example: 67890

Body

application/json

productIdinteger · int64Required

상품 식별용 ID

Example: 67890

remainingCountinteger · int32Required

현재 판매 가능한 재고 수량 (0 이상)

Example: 100

partnerNamestringOptional

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

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

successobjectOptional

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

put

/api/v3/shopping-fep/product-items/{productItemId}/stocks/normal-stock/remaining-count

HTTPcURLJavaScriptPython

PUT /api/v3/shopping-fep/product-items/{productItemId}/stocks/normal-stock/remaining-count HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "productId": 67890,
  "remainingCount": 100,
  "partnerName": "text"
}

200

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

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

택배사 목록 조회

get

사용 가능한 택배사 목록을 조회합니다.

사용처

• 상품 등록/수정 시 배송정책의 deliveryCompanyId 파라미터에 사용할 택배사 ID를 확인할 수 있습니다

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get

/api/v3/shopping-fep/delivery-companies

HTTPcURLJavaScriptPython

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

200

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

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "COMMON_ERROR",
    "reason": "text"
  },
  "success": {
    "deliveryCompanies": [
      {
        "id": 1,
        "name": "CJ대한통운",
        "code": "04",
        "isEnabled": true
      }
    ]
  }
}

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

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