API

구독 정산일 수정

작성일 2026.03.14 | 수정일 2026.03.14

PUT/cash/v1/subscribes/:subscribeId

Parameters

subscribeId— 수정할 구독의 고유 ID (32자)

구독의 정산일 설정을 변경합니다.

Body Params

Name	Type	Required	Description
settlementDay	string		변경할 정산일 유형. 'LAST'(매월 말일) 또는 'CUSTOM'(지정일).
settlementCustomDate	number		변경할 정산 지정일 (1~31). settlementDay가 'CUSTOM'인 경우 필수.

Response

Name	Type	Required	Description
subscribeId	string	*	구독 고유 ID (32자, 'CA01SU' 접두사)
accountId	string	*	계정 고유 ID
planId	string	*	구독한 플랜 ID
status	string	*	구독 상태. ACTIVE(활성), INACTIVE(비활성), NOT_PAID(미결제), DELETED(삭제됨).
settlementDay	string	*	정산일 유형. LAST(매월 말일) 또는 CUSTOM(지정일).
settlementCustomDate	number\|null	*	정산 지정일 (1~31). settlementDay가 CUSTOM인 경우에만 유효.
dateLastPaid	string	*	마지막 결제 일시 (ISO 8601)
dateCreated	string	*	구독 생성 일시 (ISO 8601)
dateUpdated	string	*	최종 수정 일시 (ISO 8601)

Structure

Request

{
  "settlementDay": "LAST"
}

Response

{
  "subscribeId": "CA01SU01234567890123456789AB",
  "accountId": "12345678901234",
  "planId": "CA01PL01234567890123456789AB",
  "status": "ACTIVE",
  "settlementDay": "LAST",
  "settlementCustomDate": null,
  "dateLastPaid": "2024-06-30T15:00:00.000Z",
  "dateCreated": "2024-01-15T10:00:00.000Z",
  "dateUpdated": "2024-07-01T12:00:00.000Z"
}