페이 스튜디오 · 상품 생성

상품 생성

링크결제와 정기결제에서 재사용할 상품을 생성하는 API입니다.

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

POST /pay/v1/products

상품 생성

링크결제와 정기결제에서 재사용할 상품을 생성하는 API입니다.

요청 파라미터

이름	타입	필수	기본값	조건	설명
`name`	string	필수	-	50자 이하	상품명입니다.
`price`	integer	필수	-	0 이상	상품 기본 금액입니다.
`sort`	integer	선택	`0`	0 이상	정렬 순서입니다.
`is_active`	boolean	선택	`True`	-	상품 사용 여부입니다.

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`key`	string	상품 key입니다.
`name`	string	상품명입니다.
`price`	integer	상품 기본 금액입니다.
`sort`	integer	정렬 순서입니다.
`is_active`	boolean	상품 사용 여부입니다.
`create_dttm`	datetime	생성일시입니다.

요청 예시

예시 생성 중…

응답 예시 성공

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