Files
sam-docs/features/finance/cards.md
권혁성 ae7e139d12 docs: [종합정비] Phase 3 신규 도메인 기능 문서 16개 작성
- features/esign/README.md: 전자서명 (4모델, 16 API)
- features/documents/README.md: 문서관리 (12모델, EAV 기반, 15 API)
- features/ai/README.md: AI 리포트 (Gemini 2.0, 4 API)
- features/equipment/README.md: 설비관리 (MNG 전용)
- features/finance/ 9개 하위문서: 입출금, 급여, 가지급금, 세금계산서,
  악성채권, 어음, 카드, 미지급비용, 채권현황, CEO 대시보드
- features/finance/README.md 재구조화 (14개 하위문서 목록)
- features/barobill-kakaotalk/README.md 확장 (API 설정 + 세금계산서)
- rules/numbering-rules.md: 채번규칙 (6세그먼트, 원자적 UPSERT)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 18:03:25 +09:00

1.5 KiB

카드관리 (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} 거래 삭제

관련 문서