에이전시가 하위 고객사에 크레딧을 지급합니다. 지급한 만큼 에이전시 잔액에서 차감됩니다.

고객사 크레딧 지급

에이전시가 자기 하위 고객사에 크레딧을 지급합니다.

동작이 바뀌었습니다. 예전에는 고객사 잔액만 늘고 에이전시 잔액은 그대로였습니다 (사실상 무제한 지급). 이제 한 번의 지급이 두 원장을 함께 움직입니다 — 에이전시에서 빠지고 고객사로 들어갑니다.

HTTP 요청

POST /me/clients/{id}/credit
Authorization: Bearer {access_token}
Content-Type: application/json

{ "amount": 300000, "memo": "6월 예산" }

파라미터	위치	타입	필수	설명
`id`	path	`String`	예	고객사 memberId
`amount`	body	`Integer`	예	지급액. 0 이하면 거부
`memo`	body	`String`	아니오	지급 사유. 최대 500자

무엇이 바뀌었나

	이전	현재
고객사 잔액	+지급액	+지급액 (동일)
고객사 원장	`AGENCY_GRANT` 행 추가	동일
에이전시 잔액	변화 없음	-지급액
에이전시 원장	행 없음	`AGENCY_GRANT_OUT` 행 추가

잔액이 모자라도 지급은 막지 않습니다. 에이전시 잔액이 음수로 내려갑니다. 대신 그 경우 결제/정산 Slack 채널로 영업에게 알림이 갑니다. 프론트에서 별도로 잔액 검사를 하거나 지급 버튼을 막을 필요는 없습니다.

응답 (200 OK)

{ "id": "client@example.com", "creditBalance": 400000 }

필드	설명
`id`	고객사 memberId
`creditBalance`	고객사의 지급 후 잔액

creditBalance 는 고객사 잔액입니다. 에이전시 자기 잔액은 이 응답에 없습니다. 지급 후 에이전시 잔액을 화면에 갱신하려면 GET /me 를 다시 호출하세요.

지급 내역 조회

GET /me/clients/{id}/credit

고객사 원장을 발생일 최신순으로 돌려줍니다. 소프트 삭제된 행은 빠집니다.

[
  {
    "id": "1024",
    "type": "grant",
    "amount": 300000,
    "balanceAfter": 400000,
    "memo": "6월 예산",
    "createdAt": "2026-08-20T14:03:11"
  }
]

`type` 값

값	의미
`grant`	유입 (지급·충전·환급)
`use`	유출 (사용·차감·캠페인 입금)
`adjust`	그 외

에이전시 원장에 새로 생기는 AGENCY_GRANT_OUT 은 use 로 내려갑니다. 다만 이 조회는 고객사 원장이라 여기에는 나타나지 않습니다. 에이전시 자기 내역을 보여주는 화면이 생기면 그때 노출됩니다.

에러

상태 코드	설명
`400`	`amount` 가 없거나 0 이하
`400`	`memo` 가 500자 초과 — `AGENCY_CREDIT_MEMO_TOO_LONG`(`args.maxLength`=500). 예전에는 `DATABASE_ERROR`로 실패했습니다
`403`	내 에이전시 소속 고객사가 아님

고객사 크레딧 지급

고객사 크레딧 지급

HTTP 요청

무엇이 바뀌었나

응답 (200 OK)

지급 내역 조회

`type` 값

에러

API 테스트

On this page