Admin APIAdmin Finance API GET /ai/admin/finance/business/{businessAccountId}
기업 파이낸스 상세 (요약 + 캠페인 리스트 + 글로벌 타임라인)
기업의 잔액·LOCK·누적 충전/입금 합계와, 해당 기업의 캠페인 리스트,
그리고 글로벌 크레딧 타임라인(collab_no IS NULL 인 트랜잭션) 을 반환합니다.
GET /ai/admin/finance/business/{businessAccountId}
Authorization: Bearer {access_token}
| 파라미터 | 타입 | 필수 | 설명 |
|---|
businessAccountId | Long | 예 | 기업 PK (Business.businessAccountId) |
{
"status": 200,
"code": null,
"message": "기업 상세 조회 완료",
"data": {
"summary": {
"businessAccountId": 12,
"memberId": "brandA",
"businessName": "A브랜드",
"remainCredit": 1500000,
"totalLocked": 300000
},
"totalCharged": 3000000,
"totalDeposited": 1500000,
"campaigns": [
{
"collabNo": 482,
"title": "여름 신상 캠페인",
"productName": "선크림 50ml",
"businessAccountId": 12,
"businessName": "A브랜드",
"totalDeposited": 500000,
"totalLocked": 300000
}
],
"globalTimeline": [
{
"sourceKey": "creditTx:1042",
"type": "CARD_PAYMENT",
"amount": 1000000,
"balanceAfter": 1500000,
"collabNo": null,
"candyPaymentId": "order_abc",
"occurredAt": "2026-05-20T10:11:00",
"description": "결제 충전",
"reason": null,
"memo": null,
"reverseOfTxId": null,
"reversed": false,
"createdBy": "system"
}
]
}
}
| 필드 | 타입 | 설명 |
|---|
summary | BusinessFinanceSummaryDto | 요약 |
totalCharged | Integer | PAYMENT 양수 amount 누적 |
totalDeposited | Integer | CAMPAIGN_DEPOSIT abs 누적 |
campaigns | CollabFinanceSummaryDto[] | 이 기업의 캠페인 리스트 (최신순) |
globalTimeline | FinanceTimelineEntryDto[] | 글로벌(collab_no IS NULL) 거래 이력 |
| 필드 | 타입 | 설명 |
|---|
sourceKey | String | 출처 식별자 (creditTx:{id} / budgetLock:{id} / budgetUnlock:{id}) |
type | FinanceTimelineEntryType | 분류 (CARD_PAYMENT / CREDIT_ADD / ... — 자세한 매핑은 index 참조) |
amount | Integer | 양수=증가, 음수=감소 |
balanceAfter | Integer | CreditTransaction 출처일 때 잔액 스냅샷 |
collabNo | Integer? | 캠페인 번호 |
candyPaymentId | String? | 결제 ID |
occurredAt | LocalDateTime | 거래/이벤트 시각 |
description | String? | 시스템 자동 설명 |
reason | CreditTransactionReason? | 어드민 수동 거래 사유 |
memo | String? | 어드민 자유 메모 |
reverseOfTxId | Long? | 이 row 가 reverse 행이면 원본 tx id |
reversed | Boolean | 이 row 가 다른 reverse 에 의해 취소되었는지 (UI 취소선) |
createdBy | String? | 처리자 |