API

잔액 소진 알림 설정

작성일 2026.03.11 | 수정일 2026.03.11

PUT/cash/v1/balance/alert

알림을 받을 기준 금액과 알림 수신 채널을 설정합니다. 기준 금액은 최소 200원에서 최대 100,000,000원까지, 최대 3개까지 설정할 수 있습니다.

Body Params

Name	Type	Required	Description
balances	number[]	*	알림을 받을 기준 금액 목록 (원). 최소 1개, 최대 3개. 각 금액은 200원 이상 100,000,000원 이하. 중복 불가.
channels	string[]	*	알림 수신 채널 목록. 최소 1개, 최대 2개. `SMS`, `ATA`(카카오 알림톡), `EMAIL` 중 선택. 중복 불가.

Name	Type	Required	Description
message	string	*	결과 메시지

Request

{
  "balances": [
    1000,
    5000,
    10000
  ],
  "channels": [
    "SMS",
    "EMAIL"
  ]
}

Response

{
  "message": "성공적으로 등록되었습니다."
}