API

서브계정 잔액 충전/차감

작성일 2026.03.21 | 수정일 2026.03.21

POST/appstore/v2/me/apps/:appId/subaccounts/:subAccountId/balance

Parameters

appId*— SITE 앱 ID

subAccountId*— 대상 서브계정 ID

마스터 계정과 서브계정 간 잔액/포인트를 이체합니다.

Body Params

Name	Type	Required	Description
rechargeType	string	*	이체 유형. 'RECHARGE' (마스터→서브) 또는 'DEDUCT' (서브→마스터)
balance	number		이체할 잔액 (원). point와 둘 중 하나 이상 필수
point	number		이체할 포인트. balance와 둘 중 하나 이상 필수

Response

Name	Type	Required	Description
ownerBalance	object	*	마스터 계정 잔액 정보
accountId	string		마스터 계정 ID
balance	number		마스터 계정 잔액 (원)
point	number		마스터 계정 포인트
subMemberBalance	object	*	서브계정 잔액 정보
accountId	string		서브계정 ID
balance	number		서브계정 잔액 (원)
point	number		서브계정 포인트

Structure

Request

{
  "rechargeType": "RECHARGE",
  "balance": 10000,
  "point": 5000
}

Response

{
  "ownerBalance": {
    "accountId": "99999999999999",
    "balance": 90000,
    "point": 45000
  },
  "subMemberBalance": {
    "accountId": "12345678901234",
    "balance": 60000,
    "point": 15000
  }
}