Products

상품(Product)을 조회해요.
가격·전달물·환불 정책 등 셀러 콘솔에서 설정한 값을 API로 읽어올 수 있어요.
상품 생성·수정은 셀러 콘솔에서 하고, 공개 API는 읽기 전용이에요.

상품 목록

GEThttps://api.payri.kr/v1/productsscope products:read


curl "https://api.payri.kr/v1/products?page=1&limit=20" \
  -H "X-Api-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

목록은 공통 페이지네이션 형식(data·total·page·limit)으로 와요.
페이지네이션 규약은 REST API 개요에서 다뤄요.

상품 단건

GEThttps://api.payri.kr/v1/products/:idscope products:read


curl https://api.payri.kr/v1/products/prod_88x \
  -H "X-Api-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"


{
  "id": "prod_88x",
  "storeId": "store_1a2b",
  "name": "MeetNote Solo",
  "summary": "1인용 회의 노트 앱",
  "description": "회의 녹음을 자동으로 요약해주는 데스크톱 앱이에요.",
  "icon": "bx bx-note",
  "pricing": { "type": "one_time", "currency": "KRW", "amount": 19000 },
  "linkId": "lnk_a1b2c3",
  "salesCount": 42,
  "deliverable": { "type": "license", "value": "", "maxActivations": 3 },
  "status": "active",
  "listed": true,
  "contents": [
    { "type": "license", "label": "라이선스 키 1개" },
    { "type": "update", "label": "1년 무료 업데이트" }
  ],
  "refundPolicy": { "type": "within_7days" },
  "createdAt": "2026-05-01T00:00:00.000Z"
}

주요 필드

필드	타입	설명
`id`	string	상품 ID (`prod_`로 시작)
`pricing`	object	가격 정보. 단건이면 `type: "one_time"` + `amount`, 구독이면 `type: "subscription"` + `plans` 배열
`linkId`	string	결제 링크 ID (가격 단위)
`deliverable`	object	전달물 (`type`: `file`/`license`/`link`)
`status`	enum	`draft` · `active` · `archived`
`listed`	boolean	스토어 노출 여부
`contents`	array	구성품 표기 목록 `{ type, label }`
`refundPolicy`	object	환불 정책 (`type`: `no_refund`/`before_delivery`/`within_7days`/`custom`)
`stockLimit`	int	재고 한도 (설정했을 때만)

전달물 종류·가격 구조는 가이드에서 자세히 다뤄요.
전달물이 license면 발급 방식은 라이선스 연동에서 결정해요.