52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
|
# 카드관리 (Cards & Card Transactions)
|
||
|
|
|
||
|
|
> **최종 갱신**: 2026-02-27
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 1. 개요
|
||
|
|
|
||
|
|
법인카드 등록·관리 및 카드 사용내역 조회·계정과목 배정.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. API 엔드포인트
|
||
|
|
|
||
|
|
### 카드 관리
|
||
|
|
|
||
|
|
| HTTP | URI | 설명 |
|
||
|
|
|------|-----|------|
|
||
|
|
| GET | `/v1/cards` | 카드 목록 |
|
||
|
|
| POST | `/v1/cards` | 카드 등록 |
|
||
|
|
| GET | `/v1/cards/active` | 활성 카드 목록 |
|
||
|
|
| GET | `/v1/cards/{id}` | 카드 상세 |
|
||
|
|
| PUT | `/v1/cards/{id}` | 카드 수정 |
|
||
|
|
| DELETE | `/v1/cards/{id}` | 카드 삭제 |
|
||
|
|
| PATCH | `/v1/cards/{id}/toggle` | 상태 토글 |
|
||
|
|
|
||
|
|
**Card 모델 특이사항:**
|
||
|
|
- `card_number_encrypted`: 카드번호 자동 암호화
|
||
|
|
- `card_password_encrypted`: 비밀번호 자동 암호화
|
||
|
|
- `getMaskedCardNumber()`: 마스킹 처리된 번호 반환
|
||
|
|
|
||
|
|
### 카드 거래내역
|
||
|
|
|
||
|
|
| HTTP | URI | 설명 |
|
||
|
|
|------|-----|------|
|
||
|
|
| GET | `/v1/card-transactions` | 거래 목록 |
|
||
|
|
| POST | `/v1/card-transactions` | 거래 등록 |
|
||
|
|
| GET | `/v1/card-transactions/summary` | 요약 |
|
||
|
|
| GET | `/v1/card-transactions/dashboard` | 대시보드 |
|
||
|
|
| PUT | `/v1/card-transactions/bulk-update-account` | 계정과목 일괄 수정 |
|
||
|
|
| GET | `/v1/card-transactions/{id}` | 거래 상세 |
|
||
|
|
| PUT | `/v1/card-transactions/{id}` | 거래 수정 |
|
||
|
|
| DELETE | `/v1/card-transactions/{id}` | 거래 삭제 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 관련 문서
|
||
|
|
|
||
|
|
- [재무관리 개요](README.md)
|
||
|
|
- [법인카드·차량 관리](../card-vehicle/README.md) — 차량 관련 카드 사용
|
||
|
|
- Swagger: `/api-docs` → Cards / CardTransactions 섹션
|