Develop

prisma/migrations/20260203073133_add_method_column/migration.sql

@@ -0,0 +1,11 @@
+/*
+  Warnings:
+
+  - The values [kakaopay,tosspay] on the enum `Payment_provider` will be removed. If these variants are still used in the database, this will fail.
+
+*/
+-- AlterTable
+ALTER TABLE `Payment` ADD COLUMN `cash_receipt_type` VARCHAR(191) NULL,
+    ADD COLUMN `cash_receipt_url` VARCHAR(191) NULL,
+    ADD COLUMN `method` ENUM('CARD', 'VIRTUAL_ACCOUNT', 'TRANSFER', 'MOBILE', 'EASY_PAY') NOT NULL DEFAULT 'CARD',
+    MODIFY `provider` ENUM('TOSSPAYMENTS', 'KAKAOPAY', 'NAVERPAY', 'TOSSPAY', 'SAMSUNGPAY', 'APPLEPAY', 'LPAY', 'PAYCO', 'SSG', 'PINPAY') NOT NULL;

prisma/migrations/20260203073423_remove_default_value/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE `Payment` ALTER COLUMN `method` DROP DEFAULT;

prisma/schema.prisma

@@ -392,17 +392,44 @@ model Purchase {
   @@index([user_id], map: "Purchase_user_id_fkey")
 }
 
+// 결제 수단
+enum PaymentMethod {
+  CARD              // 카드
+  VIRTUAL_ACCOUNT   // 가상계좌
+  TRANSFER          // 계좌이체
+  MOBILE            // 휴대폰
+  EASY_PAY          // 간편결제
+}
+
+// 구체적인 PG사 또는 간편결제사
+enum PaymentProvider {
+  TOSSPAYMENTS      // 일반 토스 PG (카드, 가상계좌 등)
+  KAKAOPAY          // 카카오페이
+  NAVERPAY          // 네이버페이
+  TOSSPAY           // 토스페이
+  SAMSUNGPAY        // 삼성페이
+  APPLEPAY          // 애플페이
+  LPAY              // 엘페이
+  PAYCO             // 페이코
+  SSG               // SSG페이
+  PINPAY            // 핀페이
+}
+
 model Payment {
   payment_id   Int              @id @default(autoincrement())
   purchase_id  Int              @unique
   status       Status
-  provider     Payment_provider
+  method       PaymentMethod    
+  provider     PaymentProvider
   merchant_uid String           @unique
   created_at   DateTime         @default(now())
   updated_at   DateTime         @updatedAt
   imp_uid      String           @unique
   purchase     Purchase         @relation(fields: [purchase_id], references: [purchase_id], onDelete: Cascade)
   settlement   Settlement?
+  // 현금영수증 정보 (가상계좌/계좌이체 시)
+  cash_receipt_url  String?      // 영수증 조회 URL
+  cash_receipt_type String?      // 소득공제(DEDUCTION), 지출증빙(PROOF) 등
 }
 
 model Settlement {
@@ -588,11 +615,6 @@ enum NotificationType {
   ADMIN_MESSAGE
 }
 
-enum Payment_provider {
-  kakaopay
-  tosspay
-}
-
 enum userStatus {
   active
   banned

src/purchases/dtos/purchase.dto.ts

@@ -1,9 +1,11 @@
+import { PaymentProvider } from "@prisma/client";
+
 export interface PurchaseHistoryItemDTO {
     prompt_id: number;
     title: string;
     price: number;
     seller_nickname: string;
-    pg: 'kakaopay' | 'tosspay';
+    pg: PaymentProvider | null;
 }
 
 export interface PurchaseHistoryResponseDTO {

src/purchases/dtos/purchase.request.dto.ts

@@ -1,12 +1,3 @@
 export interface PromptPurchaseRequestDTO {
   prompt_id: number;
-  pg: 'kakaopay' | 'tosspay';  // 결제 수단
-  merchant_uid: string;             // 고유 주문번호
-  amount: number;
-  buyer_name: string;
-  redirect_url: string;
-   custom_data: {
-    prompt_id: number;
-    user_id: number;
-  };
 }

src/purchases/repositories/purchase.complete.repository.ts

@@ -1,9 +1,9 @@
-import { Prisma } from '@prisma/client';
+import { Prisma, PaymentMethod, PaymentProvider, Status } from '@prisma/client';
 
 type Tx = Prisma.TransactionClient;
 
 export const PurchaseCompleteRepository = {
-   createPurchaseTx(tx: Tx, data: {
+  createPurchaseTx(tx: Tx, data: {
     user_id: number;
     prompt_id: number;
     seller_id?: number;
@@ -16,17 +16,23 @@ export const PurchaseCompleteRepository = {
   createPaymentTx(tx: Tx, data: {
     purchase_id: number;
     merchant_uid: string;
-    pg: 'kakaopay' | 'tosspay';
-    status: 'Succeed' | 'Failed' | 'Pending';
+    method: PaymentMethod;      
+    provider: PaymentProvider;       
+    status: Status; 
     paymentId: string;
+    cash_receipt_url?: string | null;
+    cash_receipt_type?: string | null;
   }) {
     return tx.payment.create({
       data: {
         purchase: { connect: { purchase_id: data.purchase_id } },
         merchant_uid: data.merchant_uid,
-        provider: data.pg,
-        status: data.status,
         imp_uid: data.paymentId,
+        method: data.method,
+        provider: data.provider,
+        status: data.status,
+        cash_receipt_url: data.cash_receipt_url,
+        cash_receipt_type: data.cash_receipt_type,
       },
     });
   },
@@ -36,7 +42,7 @@ export const PurchaseCompleteRepository = {
     paymentId: number;
     amount: number;
     fee: number;
-    status: 'Succeed' | 'Failed' | 'Pending';
+    status: Status;
   }) {
     return tx.settlement.upsert({
       where: { payment_id: input.paymentId },

src/purchases/routes/purchase.request.route.ts

@@ -17,8 +17,8 @@ const router = Router();
  * @swagger
  * /api/prompts/purchases/requests:
  *   post:
- *     summary: 결제 요청 생성
- *     description: 결제 시작을 위한 요청을 생성합니다.
+ *     summary: 결제 요청 생성 (사전 검증)
+ *     description: 프론트엔드에서 결제창을 띄우기 전, 주문 번호 생성 및 사전 검증을 수행합니다.
  *     tags: [Purchase]
  *     security:
  *       - jwt: []
@@ -28,55 +28,48 @@ const router = Router();
  *         application/json:
  *           schema:
  *             type: object
+ *             required:
+ *               - prompt_id
+ *               - merchant_uid
+ *               - amount
+ *               - buyer_name
+ *               - redirect_url
  *             properties:
  *               prompt_id:
  *                 type: integer
- *               pg:
- *                 type: string
- *                 enum: [kakaopay, tosspayments]
  *               merchant_uid:
  *                 type: string
+ *                 description: 가맹점 주문 번호
  *               amount:
  *                 type: integer
+ *                 description: 결제 예정 금액
  *               buyer_name:
  *                 type: string
  *               redirect_url:
  *                 type: string
  *     responses:
  *       200:
- *         description: 결제 요청 생성 성공
+ *         description: 요청 성공
  *         content:
  *           application/json:
  *             schema:
  *               type: object
  *               properties:
  *                 message:
  *                   type: string
- *                 payment_gateway:
- *                   type: string
  *                 merchant_uid:
  *                   type: string
- *                 redirect_url:
- *                   type: string
  *                 statusCode:
  *                   type: integer
- *       400:
- *         description: 잘못된 요청
- *       401:
- *         description: 인증 실패
- *       404:
- *         description: 리소스 없음
- *       409:
- *         description: 중복/상태 충돌
  */
 router.post('/requests', authenticateJwt, PurchaseRequestController.requestPurchase);
 
 /**
  * @swagger
  * /api/prompts/purchases/complete:
  *   post:
- *     summary: 결제 완료 처리(Webhook/리다이렉트 후 서버 검증)
- *     description: 포트원 imp_uid 기반으로 서버에서 결제 검증 후 구매/결제/정산을 기록합니다.
+ *     summary: 결제 완료 처리 (검증 및 저장)
+ *     description: 포트원 결제 완료 후, paymentId를 서버로 보내 검증하고 구매를 확정합니다.
  *     tags: [Purchase]
  *     security:
  *       - jwt: []
@@ -86,14 +79,18 @@ router.post('/requests', authenticateJwt, PurchaseRequestController.requestPurch
  *         application/json:
  *           schema:
  *             type: object
+ *             required:
+ *               - paymentId
  *             properties:
- *               imp_uid:
+ *               paymentId:
  *                 type: string
+ *                 description: 포트원 V2 결제 ID
  *               merchant_uid:
  *                 type: string
+ *                 description: 가맹점 주문 번호
  *     responses:
  *       200:
- *         description: 결제 완료 처리 성공
+ *         description: 결제 성공 및 저장 완료
  *         content:
  *           application/json:
  *             schema:
@@ -106,54 +103,23 @@ router.post('/requests', authenticateJwt, PurchaseRequestController.requestPurch
  *                   enum: [Succeed, Failed, Pending]
  *                 purchase_id:
  *                   type: integer
- *                   nullable: true
  *                 statusCode:
  *                   type: integer
- *       400:
- *         description: 검증 실패/유효하지 않은 요청
- *       401:
- *         description: 인증 실패
- *       404:
- *         description: 리소스 없음
- *       409:
- *         description: 충돌
- *       500:
- *         description: 서버 오류
  */
 router.post('/complete', authenticateJwt, PurchaseCompleteController.completePurchase);
 
 /**
  * @swagger
  * /api/prompts/purchases:
  *   get:
- *     summary: 내 결제 내역 조회
- *     description: 인증된 사용자의 결제(구매) 내역을 조회합니다.
+ *     summary: 결제 내역 조회
+ *     description: 인증된 사용자의 결제 내역을 최신순으로 조회합니다.
  *     tags: [Purchase]
  *     security:
  *       - jwt: []
- *     parameters:
- *       - in: query
- *         name: page
- *         schema:
- *           type: integer
- *         required: false
- *         description: 페이지 번호 (옵션)
- *       - in: query
- *         name: pageSize
- *         schema:
- *           type: integer
- *         required: false
- *         description: 페이지 크기 (옵션)
- *       - in: query
- *         name: status
- *         schema:
- *           type: string
- *           enum: [Succeed, Failed, Pending]
- *         required: false
- *         description: 결제 상태 필터 (옵션)
  *     responses:
  *       200:
- *         description: 결제 내역 조회 성공
+ *         description: 조회 성공
  *         content:
  *           application/json:
  *             schema:
@@ -172,21 +138,18 @@ router.post('/complete', authenticateJwt, PurchaseCompleteController.completePur
  *                         type: string
  *                       price:
  *                         type: integer
+ *                       seller_nickname:
+ *                         type: string
  *                       purchased_at:
  *                         type: string
  *                         format: date-time
- *                       seller_nickname:
- *                         type: string
- *                         nullable: true
  *                       pg:
  *                         type: string
- *                         enum: [kakaopay, tosspay, null]
+ *                         description: 결제 제공자 (DB Enum)
+ *                         enum: [TOSSPAYMENTS, KAKAOPAY, TOSSPAY, NAVERPAY, SAMSUNGPAY, APPLEPAY, LPAY, PAYCO, SSG, PINPAY]
+ *                         nullable: true
  *                 statusCode:
  *                   type: integer
- *       401:
- *         description: 인증 실패
- *       500:
- *         description: 서버 오류
  */
 router.get('/', authenticateJwt, PurchaseHistoryController.list);
 

src/purchases/services/purchase.complete.service.ts

@@ -4,7 +4,6 @@ import { PurchaseCompleteRepository } from '../repositories/purchase.complete.re
 import { AppError } from '../../errors/AppError';
 import prisma from '../../config/prisma';
 import { fetchAndVerifyPortonePayment } from '../utils/portone';
-import { mapPgProvider } from '../utils/payment.util';
 
 export const PurchaseCompleteService = {
   async completePurchase(userId: number, dto: PromptPurchaseCompleteRequestDTO): Promise<PromptPurchaseCompleteResponseDTO> {
@@ -32,9 +31,6 @@ export const PurchaseCompleteService = {
       throw new AppError('이미 구매한 프롬프트입니다.', 409, 'AlreadyPurchased');
     }
 
-    // 5. 트랜잭션 처리
-    const pgProvider = mapPgProvider(verifiedPayment.method_provider);
-
     const { purchase_id } = await prisma.$transaction(async (tx) => {
         // 구매 기록 생성
         const purchase = await PurchaseCompleteRepository.createPurchaseTx(tx, {
@@ -49,9 +45,12 @@ export const PurchaseCompleteService = {
         const payment = await PurchaseCompleteRepository.createPaymentTx(tx, {
             purchase_id: purchase.purchase_id,
             merchant_uid: paymentId,
-            pg: pgProvider,
+            paymentId: paymentId,
             status: 'Succeed',
-            paymentId: paymentId
+            method: verifiedPayment.method,     
+            provider: verifiedPayment.provider, 
+            cash_receipt_url: verifiedPayment.cashReceipt?.url,
+            cash_receipt_type: verifiedPayment.cashReceipt?.type,
         });
 
         // 정산 데이터 생성

src/purchases/services/purchase.request.service.ts

@@ -1,3 +1,4 @@
+import { v4 as uuidv4 } from 'uuid';
 import { PromptPurchaseRequestDTO } from '../dtos/purchase.request.dto';
 import { PurchaseRequestRepository } from '../repositories/purchase.request.repository';
 import { AppError } from '../../errors/AppError';
@@ -12,16 +13,18 @@ export const PurchaseRequestService = {
     const existing = await PurchaseRequestRepository.findExistingPurchase(userId, dto.prompt_id);
     if (existing) throw new AppError('이미 구매한 프롬프트입니다.', 409, 'AlreadyPurchased');
 
+    const paymentId = `payment-${uuidv4()}`;
+
     return {
-      message: '결제 요청이 정상 처리되었습니다.',
-      payment_gateway: dto.pg,
-      merchant_uid: dto.merchant_uid,
-      redirect_url: dto.redirect_url, // 클라이언트가 넘긴 값 사용
-       custom_data: {
+      message: '주문서가 생성되었습니다.',
+      statusCode: 200,
+      merchant_uid: paymentId,
+      amount: prompt.price,
+      prompt_title: prompt.title,
+      custom_data: {
         prompt_id: dto.prompt_id, 
         user_id: userId,
       },
-      statusCode: 200,
     };
   },
 };