페이 스튜디오 · 상품 목록 조회

상품 목록 조회

링크결제와 정기결제에서 사용할 상품 목록을 조회하는 API입니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.

GET /pay/v1/products

상품 목록 조회

링크결제와 정기결제에서 사용할 상품 목록을 조회하는 API입니다.

요청 파라미터

이름	타입	필수	기본값	조건	설명
`is_active`	boolean	선택	-	-	조회할 상품 사용 여부입니다. true면 사용 중, false면 미사용 상품만 조회합니다. 지정하지 않으면 전체입니다.
`page`	integer	선택	`1`	1 이상	페이지 번호입니다.
`cnt`	integer	선택	`20`	1~20	페이지당 목록 개수입니다.

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`page`	integer	현재 페이지입니다.
`maxpage`	integer	마지막 페이지입니다.
`cnt`	integer	반환 기준 개수입니다.
`total`	integer	전체 상품 수입니다.
`items` 6개 필드	array	상품 목록입니다.
`key`	string	상품 key입니다.
`name`	string	상품명입니다.
`price`	integer	상품 기본 금액입니다.
`sort`	integer	정렬 순서입니다.
`is_active`	boolean	상품 사용 여부입니다.
`create_dttm`	datetime	생성일시입니다.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "page": 1,
  "maxpage": 1,
  "cnt": 20,
  "total": 1,
  "items": [
    {
      "key": "f1e2d3c4b5a6978869aa",
      "name": "월 유지보수",
      "price": 110000,
      "sort": 1,
      "is_active": true,
      "create_dttm": "2026-06-16 10:00:00"
    }
  ]
}