API

플랜 단건 조회

작성일 2026.03.14 | 수정일 2026.03.14

GET/cash/v1/plans/:planId

Parameters

planId— 조회할 플랜의 고유 ID (32자)

특정 플랜의 상세 정보를 조회합니다.

Response

단일 플랜 객체가 반환됩니다.

Name	Type	Required	Description
planId	string	*	플랜 고유 ID (32자, 'CA01PL' 접두사)
name	string	*	플랜 이름
supplyPrice	number	*	공급가액 (원)
tax	number	*	세금 (원)
totalPrice	number	*	총액 (원). supplyPrice + tax.
useHook	boolean	*	웹훅 사용 여부
hook	object\|null	*	웹훅 설정 정보. useHook이 false이면 null.
url	string	*	웹훅 수신 URL
customData	any		사용자 정의 데이터
dateCreated	string	*	생성 일시 (ISO 8601)
dateUpdated	string	*	최종 수정 일시 (ISO 8601)

Structure

Response

{
  "planId": "CA01PL01234567890123456789AB",
  "name": "Basic Plan",
  "supplyPrice": 9091,
  "tax": 909,
  "totalPrice": 10000,
  "useHook": true,
  "hook": {
    "url": "https://example.com/webhook",
    "customData": {
      "tier": "basic"
    }
  },
  "dateCreated": "2024-01-01T00:00:00.000Z",
  "dateUpdated": "2024-06-01T00:00:00.000Z"
}