Develop

prisma/migrations/20260522020000_add_business_type_enum_and_column/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE `SettlementAccount` ADD COLUMN `business_type` ENUM('PERSONAL', 'CORPORATE') NULL;

prisma/schema.prisma

@@ -460,6 +460,11 @@ enum SellerType {
   BUSINESS
 }
 
+enum BusinessType {
+  PERSONAL    // 개인사업자
+  CORPORATE   // 법인사업자
+}
+
 enum ApprovalStatus {
   PENDING   // 심사 대기중
   APPROVED  // 승인 완료
@@ -473,7 +478,8 @@ model SettlementAccount {
   account_number String   @db.VarChar(30)
   account_holder String   @db.VarChar(100)
   seller_type    SellerType      @default(INDIVIDUAL)
-  birth_date     String?  @db.VarChar(10)
+  business_type  BusinessType?   // BUSINESS일 때만 PERSONAL/CORPORATE 지정
+  birth_date     String?  @db.VarChar(10)  // 정책상 미저장 (PII 폐기). Phase 11에서 컬럼 제거 검토
   status         ApprovalStatus  @default(APPROVED) // 개인은 즉시 승인, 사업자는 PENDING으로 생성
   is_active      Boolean  @default(true)
   representative_name  String?         @db.VarChar(100)

src/settlements/constants/bank.ts

@@ -1,24 +1,71 @@
-// 페이플 bank_code_std (KFTC 표준 3자리 은행 코드)
+// 페이플 bank_code_std (KFTC 표준 3자리 금융기관 코드)
+// 출처: Payple 정산지급대행 공식 명세
 export const PAYPLE_BANKS: Record<string, string> = {
-  "002": "산업은행",
-  "003": "기업은행",
-  "004": "국민은행",
+  // 은행
+  "002": "KDB산업은행",
+  "003": "IBK기업은행",
+  "004": "KB국민은행",
   "007": "수협은행",
-  "008": "수출입은행",
-  "011": "농협은행",
-  "012": "지역농축협",
+  "011": "NH농협은행",
   "020": "우리은행",
   "023": "SC제일은행",
   "027": "한국씨티은행",
-  "031": "아이엠뱅크(대구)",
+  "031": "아이엠뱅크 (구 대구은행)",
   "032": "부산은행",
   "034": "광주은행",
   "035": "제주은행",
   "037": "전북은행",
   "039": "경남은행",
-  "045": "새마을금고",
-  "048": "신협",
-  "050": "저축은행",
+  "081": "하나은행",
+  "088": "신한은행",
+  "089": "케이뱅크",
+  "090": "카카오뱅크",
+  "092": "토스뱅크",
+
+  // 상호금융기관
+  "012": "농협중앙회(단위농축협)",
+  "030": "수산업협동조합중앙회",
+  "045": "새마을금고중앙회",
+  "048": "신협중앙회",
+  "050": "저축은행중앙회",
+  "064": "산림조합중앙회",
+  "071": "우정사업본부(우체국)",
+
+  // 금융투자회사 (증권사)
+  "209": "유안타증권",
+  "218": "KB증권",
+  "227": "다올투자증권",
+  "238": "미래에셋증권",
+  "240": "삼성증권",
+  "243": "한국투자증권",
+  "247": "NH투자증권",
+  "261": "교보증권",
+  "262": "아이엠증권",
+  "263": "현대차증권",
+  "264": "키움증권",
+  "265": "LS증권",
+  "266": "SK증권",
+  "267": "대신증권",
+  "269": "한화투자증권",
+  "270": "하나증권",
+  "271": "토스증권",
+  "278": "신한금융투자",
+  "279": "DB증권",
+  "280": "유진투자증권",
+  "287": "메리츠증권",
+
+  // 보험사
+  "436": "교보생명",
+  "443": "DB손해보험",
+
+  // 캐피탈사
+  "304": "현대캐피탈",
+};
+
+// Payple 명세에서 제거된 코드 — 기존 등록 사용자 호환 보존용.
+// 신규 등록/인증에는 사용 금지. Phase 11 운영 마이그레이션 후 제거 예정.
+export const LEGACY_PAYPLE_BANKS: Record<string, string> = {
+  "008": "수출입은행",
   "054": "HSBC은행",
   "055": "도이치은행",
   "057": "제이피모간체이스은행",
@@ -28,14 +75,15 @@ export const PAYPLE_BANKS: Record<string, string> = {
   "061": "비엔피파리바은행",
   "062": "중국공상은행",
   "063": "중국은행",
-  "064": "산림조합",
   "067": "중국건설은행",
-  "071": "우체국",
   "076": "신용보증기금",
   "077": "기술보증기금",
-  "081": "하나은행",
-  "088": "신한은행",
-  "089": "케이뱅크",
-  "090": "카카오뱅크",
-  "092": "토스뱅크",
 };
+
+export const ALL_KNOWN_BANKS: Record<string, string> = { ...PAYPLE_BANKS, ...LEGACY_PAYPLE_BANKS };
+
+export const isValidPaypleBank = (code: string): boolean =>
+  Object.prototype.hasOwnProperty.call(PAYPLE_BANKS, code);
+
+export const isKnownBank = (code: string): boolean =>
+  Object.prototype.hasOwnProperty.call(ALL_KNOWN_BANKS, code);

src/settlements/controllers/settlement.account.controller.ts

@@ -1,37 +1,57 @@
 import { Request, Response } from 'express';
-import { verifyAndSaveAccount, getAccountInfo } from '../services/settlement.account.service';
-import { VerifyAccountRequestDto, ViewAccountResponseDto} from '../dtos/settlement.dto';
+import { verifySellerAccount, getAccountInfo } from '../services/settlement.account.service';
+import { VerifyAccountRequestDto, ViewAccountResponseDto } from '../dtos/settlement.dto';
 
 export const verifyAccount = async (req: Request, res: Response) => {
   try {
-    const user = req.user; 
-    
+    const user = req.user;
+
     if (!user) {
       return res.status(401).json({
-        error: "Unauthorized",
-        message: "로그인이 필요합니다.",
-        statusCode: 401
+        error: 'Unauthorized',
+        message: '로그인이 필요합니다.',
+        statusCode: 401,
       });
     }
 
     const dto: VerifyAccountRequestDto = req.body;
     const userId = (req.user as { user_id: number }).user_id;
-    const result = await verifyAndSaveAccount(userId, dto);
+    const result = await verifySellerAccount(userId, dto);
 
     return res.status(200).json({
       message: result.message,
-      statusCode: 200
+      registerToken: result.registerToken,
+      expiresIn: result.expiresIn,
+      statusCode: 200,
     });
-
   } catch (error: any) {
-    const status = error.status || 500;
-    const errorType = error.type || "InternalServerError";
-    const message = error.message || "알 수 없는 오류가 발생했습니다.";
-
+    if (error.name === 'AccountVerificationError' || error?.name === 'AccountVerificationError') {
+      return res.status(400).json({
+        error: 'AccountVerificationError',
+        subCode: error.subCode,
+        message: error.message,
+        statusCode: 400,
+      });
+    }
+    if (error.error === 'ValidationError' || error?.name === 'ValidationError') {
+      return res.status(400).json({
+        error: 'ValidationError',
+        message: error.message,
+        statusCode: 400,
+      });
+    }
+    if (error.error === 'InvalidAccountInfo') {
+      return res.status(400).json({
+        error: 'InvalidAccountInfo',
+        message: error.message,
+        statusCode: 400,
+      });
+    }
+    const status = error.statusCode || 500;
     return res.status(status).json({
-      error: errorType,
-      message: message,
-      statusCode: status
+      error: error.error || 'InternalServerError',
+      message: error.message || '알 수 없는 오류가 발생했습니다.',
+      statusCode: status,
     });
   }
 };
@@ -42,9 +62,9 @@ export const ViewAccount = async (req: Request, res: Response) => {
 
     if (!user) {
       return res.status(401).json({
-        error: "Unauthorized",
-        message: "로그인이 필요합니다.",
-        statusCode: 401
+        error: 'Unauthorized',
+        message: '로그인이 필요합니다.',
+        statusCode: 401,
       });
     }
 
@@ -53,21 +73,21 @@ export const ViewAccount = async (req: Request, res: Response) => {
     const accountData = await getAccountInfo(userId);
 
     const response: ViewAccountResponseDto = {
-      message: "계좌 정보 조회가 완료되었습니다.",
+      message: '계좌 정보 조회가 완료되었습니다.',
       data: accountData,
-      statusCode: 200
+      statusCode: 200,
     };
 
     return res.status(200).json(response);
   } catch (error: any) {
     const status = error.statusCode || 500;
-    const errorType = error.code || "InternalServerError";
-    const message = error.message || "알 수 없는 오류가 발생했습니다.";
+    const errorType = error.code || 'InternalServerError';
+    const message = error.message || '알 수 없는 오류가 발생했습니다.';
 
     return res.status(status).json({
       error: errorType,
-      message: message,
-      statusCode: status
+      message,
+      statusCode: status,
     });
   }
-}
+};