- 링크결제 API 수정

- 지급대행 수정
2025-10-21 14:24:51 +09:00
parent c3fbb91888
commit ab5bea6aeb
30 changed files with 784 additions and 590 deletions
--- a/src/entities/additional-service/model/key-in/types.ts
+++ b/src/entities/additional-service/model/key-in/types.ts
@@ -1,5 +1,5 @@
 import { DefaulResponsePagination, DefaultRequestPagination } from "@/entities/common/model/types";
-import { AdditionalServiceCategory, ExtensionRequestParams, FilterProps, ListItemProps } from "../types";
+import { AdditionalServiceCategory, ExtensionRequestParams, FilterProps } from "../types";

 // ========================================
 // 키인결제 관련 타입들
--- a/src/entities/additional-service/model/link-pay/constant.ts
+++ b/src/entities/additional-service/model/link-pay/constant.ts
@@ -0,0 +1,7 @@
+import { LinkPaymentProcessStatus } from "./types";
+
+export const ProcessStatusBtnGrouup = [
+  { name: '전체', value: LinkPaymentProcessStatus.ALL },
+  { name: '발송요청', value: LinkPaymentProcessStatus.SEND_REQUEST },
+  { name: '발송취소', value: LinkPaymentProcessStatus.SEND_CANCEL }
+]
--- a/src/entities/additional-service/model/link-pay/types.ts
+++ b/src/entities/additional-service/model/link-pay/types.ts
@@ -15,13 +15,11 @@ export interface LinkPaymentTabProps {
 }

 export enum LinkPaymentSearchCl {
-  ALL = "",
  PHONE = "PHONE_NUMBER",
  EMAIL = "EMAIL"
 }

 export enum LinkPaymentPaymentMethod {
-  ALL = "ALL",
  CARD = "CARD",
  BANK = "BANK",
  VIRTURE_BANK = "VIRTURE_BANK",
@@ -34,15 +32,15 @@ export enum LinkPaymentPaymentMethod {
 }

 export enum LinkPaymentSendMethod {
-  ALL = "ALL",
+  ALL = "",
  SMS = "SMS",
  EMAIL = "EMAIL",
  KAKAO = "KAKAO"
 }

 export enum LinkPaymentPaymentStatus {
-  ALL = "ALL",
-  ACTIVATE = "ACTIVATE",
+  ALL = "",
+  ACTIVATE = "ACTIVE",
  DEPOSIT_REQUEST = "DEPOSIT_REQUEST",
  PAYMENT_COMPLETE = "PAYMENT_COMPLETE",
  PAYMENT_FAIL = "PAYMENT_FAIL",
@@ -50,44 +48,60 @@ export enum LinkPaymentPaymentStatus {
 }

 export enum LinkPaymentSendStatus {
-  ALL = "ALL",
+  ALL = "",
  SUCCESS = "SUCCESS",
  FAIL = "FAIL"
 }

+export enum LinkPaymentProcessStatus {
+  ALL = "",
+  SEND_REQUEST = "SEND_REQUEST",
+  SEND_CANCEL = "SEND_CANCEL"
+}
+
 export enum LinkContentType {
  BASIC = "BASIC",
  ADDITIONAL = "ADDITIONAL"
 }

 export interface LinkPaymentHistoryListItem {
-  tid?: string;
-  // TODO : buyerName 필요
-  paymentDate?: string;
-  paymentStatus?: string;
+  requestId?: string;
+  cursorId?: string;
+  subReqId?: string;
+  mid?: string;
+  paymentMethod?: string;
+  detailExposure?: string;
  sendDate?: string;
+  buyerName?: string;
+  receiverInfo?: string;
+  orderId?: string;
  sendStatus?: string;
-  sendMethod?: string;
-  amount?: number;
+  paymentStatus?: string;
+  sendMethod?: LinkPaymentSendMethod;
 }

 export interface LinkPaymentWaitListItem {
-  tid?: string;
+  requestId?: string;
  scheduledSendDate?: string;
-  sendMethod?: string;
-  processStatus?: string;
-  // TODO: buyerName,phoneNumber 필요
+  sendMethod?: LinkPaymentSendMethod;
  amount?: number;
+  processStatus?: LinkPaymentProcessStatus;
+  buyerName?: string;
+  receiverInfo?: string;
 }

 export interface LinkPaymentHistoryListProps {
  additionalServiceCategory: AdditionalServiceCategory;
-  listItems: Record<string, Array<ListItemProps>>;
+  listItems: Array<LinkPaymentHistoryListItem>;
+  setTarget: (element: HTMLElement | null) => void;
+  mid: string;
 }

 export interface LinkPaymentWaitListProps {
  additionalServiceCategory: AdditionalServiceCategory;
-  listItems: Record<string, Array<ListItemProps>>;
+  listItems: Array<LinkPaymentWaitListItem>;
+  setTarget: (element: HTMLElement | null) => void;
+  mid: string;
 }

 export interface LinkPaymentHistoryFilterProps extends FilterProps {
@@ -97,15 +111,15 @@ export interface LinkPaymentHistoryFilterProps extends FilterProps {
  fromDate: string;
  toDate: string;
  paymentStatus: LinkPaymentPaymentStatus;
-  processResult: ProcessResult;
+  sendStatus: LinkPaymentSendStatus;
  sendMethod: LinkPaymentSendMethod;
  setMid: (mid: string) => void;
  setSearchType: (searchType: LinkPaymentSearchCl) => void;
  setSearchKeyword: (searchKeyWorld: string) => void;
  setStartDate: (startDate: string) => void;
  setEndDate: (endDate: string) => void;
-  setTransactionStatus: (transactionStatus: LinkPaymentPaymentStatus) => void;
-  setProcessResult: (processResult: ProcessResult) => void;
+  setPaymentStatus: (transactionStatus: LinkPaymentPaymentStatus) => void;
+  setSendStatus: (sendStatus: LinkPaymentSendStatus) => void;
  setSendMethod: (sendMethod: LinkPaymentSendMethod) => void;
 }

@@ -116,35 +130,35 @@ export interface LinkPaymentWaitFilterProps extends FilterProps {
  startDate: string;
  endDate: string;
  sendMethod: LinkPaymentSendMethod;
-  sendingStatus: LinkPaymentSendStatus;
+  processStatus: LinkPaymentProcessStatus;
  setMid: (mid: string) => void;
  setSearchType: (searchType: LinkPaymentSearchCl) => void;
  setSearchKeyword: (searchKeyWorld: string) => void;
  setStartDate: (startDate: string) => void;
  setEndDate: (endDate: string) => void;
  setSendMethod: (sendMethod: LinkPaymentSendMethod) => void;
-  setSendingStatus: (sendingStatus: LinkPaymentSendStatus) => void;
-  }
+  setProcessStatus: (sendingStatus: LinkPaymentProcessStatus) => void;
+}

 // 링크 결제 - 발송,대기 조회 확장 서비스
 // ========================================
 export interface ExtensionLinkPayHistoryListParams extends ExtensionRequestParams {
  searchCl: string;
  searchValue: string;
-  paymentMethod: string;
  fromDate: string;
  toDate: string;
-  paymentStatus: string;
-  sendStatus: string;
-  sendMethod: string;
+  paymentStatus: LinkPaymentPaymentStatus;
+  sendStatus: LinkPaymentSendStatus;
+  sendMethod: LinkPaymentSendMethod;
  page?: DefaultRequestPagination;
 }

 export interface ExtensionLinkPayHistoryListResponse extends DefaulResponsePagination {
-  content: Array<ListItemProps>
+  content: Array<LinkPaymentHistoryListItem>
 }

 export interface ExtensionLinkPayHistoryDownloadExcelParams extends ExtensionRequestParams {
+  email: string;
  searchCl: string;
  searchValue: string;
  paymentMethod: string;
@@ -164,7 +178,7 @@ export interface ExtensionLinkPayRequestParams extends ExtensionRequestParams {
  goodsName: string;
  amount: number;
  moid: string;
-  paymentExpiryDate: string;
+  paymentLimitDate: string;
  buyerName: string;
  email: string;
  phoneNumber: string;
@@ -186,7 +200,7 @@ export interface LinkPaymentFormData {
  goodsName: string;
  amount: number;
  moid: string;
-  paymentExpiryDate: string;
+  paymentLimitDate: string;
  // Step 2
  buyerName: string;
  email: string;
@@ -198,169 +212,10 @@ export interface LinkPaymentFormData {
  linkContentType: LinkContentType;
 }

-export interface ExtensionLinkPayHistoryDetailParams extends ExtensionRequestParams {
-  tid: string;
-}
-
-export interface ExtensionLinkPayHistoryDetailResponse {
-  tid: string;
-  amount: number;
-  corpName: string;
-  sendDate: string;
-  buyerName: string;
-  sendMethod: string;
-  paymentStatus: string;
-  failCount: number;
-  paymentMethod: string;
-  paymentDate: string;
-  paymentLimitDate: string;
-  email: string;
-  phoneNumber: string;
-  goodsName: string;
-  moid: string;
-}
-
-export interface ExtensionLinkPayHistoryResendParams extends ExtensionRequestParams {
-  tid: string;
-}
-
-export interface ExtensionLinkPayHistoryResendResponse {
-  status: boolean
-}
-
-
-export interface ExtensionLinkPayWaitListParams extends ExtensionRequestParams {
-  searchCl: string;
-  searchValue: string;
-  fromDate: string;
-  toDate: string;
-  sendStatus: string;
-  sendMethod: string;
-  processStatus: string;
-  page?: DefaultRequestPagination;
-}
-
-export interface ExtensionLinkPayWaitListResponse extends DefaulResponsePagination {
-  content: Array<ListItemProps>
-}
-
-export interface ExtensionLinkPayWaitDownloadExcelParams extends ExtensionRequestParams {
-  searchCl: string;
-  searchValue: string;
-  fromDate: string;
-  toDate: string;
-  sendStatus: string;
-  sendMethod: string;
-  processStatus: string;
-}
-
-export interface ExtensionLinkPayWaitDownloadExcelRespone {
-  status: boolean;
-}
-
-export interface ExtensionLinkPayWaitDetailParams extends ExtensionRequestParams {
-  tid: string;
-}
-
-export interface ExtensionLinkPayWaitDetailResponse {
-  tid: string;
-  amount: number;
-  corpName: string;
-  scheduledSendDate: string;
-  processStatus: string;
-  requestDate: string;
-  paymentLimitDate: string;
-  sendMethod: string;
-  buyerName: string
-  email: string;
-  phoneNumber: string;
-  goodsName: string;
-  moid: string;
-}
-
-export interface ExtensionLinkPayWaitDeleteParams extends ExtensionRequestParams {
-  tid: string;
-}
-
-export interface ExtensionLinkPayWaitDeleteRespone {
-  status: boolean
-}
-
-
-// 링크 결제 - 발송,대기 조회 확장 서비스
-// ========================================
-export interface ExtensionLinkPayHistoryListParams extends ExtensionRequestParams {
-  searchCl: string;
-  searchValue: string;
-  paymentMethod: string;
-  fromDate: string;
-  toDate: string;
-  paymentStatus: string;
-  sendStatus: string;
-  sendMethod: string;
-  page?: DefaultRequestPagination;
-}
-
-export interface ExtensionLinkPayHistoryListResponse extends DefaulResponsePagination {
-  content: Array<ListItemProps>
-}
-
-export interface ExtensionLinkPayHistoryDownloadExcelParams extends ExtensionRequestParams {
-  searchCl: string;
-  searchValue: string;
-  paymentMethod: string;
-  fromDate: string;
-  toDate: string;
-  paymentStatus: string;
-  sendStatus: string;
-  sendMethod: string;
-}
-
-export interface ExtensionLinkPayHistoryDownloadExcelRespone {
-  status: boolean;
-}
-
-export interface ExtensionLinkPayRequestParams extends ExtensionRequestParams {
-  sendMethod: string;
-  goodsName: string;
-  amount: number;
-  moid: string;
-  paymentExpiryDate: string;
-  buyerName: string;
-  email: string;
-  phoneNumber: string;
-  isIdentity: boolean;
-  identityType: IdentityType;
-  identityValue: string;
-  language: Language;
-  linkContentType: LinkContentType;
-}
-
-export interface ExtensionLinkPayRequestResponse {
-  status: boolean
-}
-
-export interface LinkPaymentFormData {
-  // Step 1
+export interface ExtensionLinkPayHistoryDetailParams {
  mid: string;
-  sendMethod: LinkPaymentSendMethod;
-  goodsName: string;
-  amount: number;
-  moid: string;
-  paymentExpiryDate: string;
-  // Step 2
-  buyerName: string;
-  email: string;
-  phoneNumber: string;
-  isIdentity: boolean;
-  identityType: IdentityType;
-  identityValue: string;
-  language: Language;
-  linkContentType: LinkContentType;
-}
-
-export interface ExtensionLinkPayHistoryDetailParams extends ExtensionRequestParams {
-  tid: string;
+  requestId: string;
+  subReqId: string;
 }

 export interface ExtensionLinkPayHistoryDetailResponse {
@@ -382,7 +237,8 @@ export interface ExtensionLinkPayHistoryDetailResponse {
 }

 export interface ExtensionLinkPayHistoryResendParams extends ExtensionRequestParams {
-  tid: string;
+  requestId: string;
+  sendMethod?: string;
 }

 export interface ExtensionLinkPayHistoryResendResponse {
@@ -395,7 +251,6 @@ export interface ExtensionLinkPayWaitListParams extends ExtensionRequestParams {
  searchValue: string;
  fromDate: string;
  toDate: string;
-  sendStatus: string;
  sendMethod: string;
  processStatus: string;
  page?: DefaultRequestPagination;
@@ -406,11 +261,11 @@ export interface ExtensionLinkPayWaitListResponse extends DefaulResponsePaginati
 }

 export interface ExtensionLinkPayWaitDownloadExcelParams extends ExtensionRequestParams {
+  email: string;
  searchCl: string;
  searchValue: string;
  fromDate: string;
  toDate: string;
-  sendStatus: string;
  sendMethod: string;
  processStatus: string;
 }
@@ -420,7 +275,7 @@ export interface ExtensionLinkPayWaitDownloadExcelRespone {
 }

 export interface ExtensionLinkPayWaitDetailParams extends ExtensionRequestParams {
-  tid: string;
+  requestId: string;
 }

 export interface ExtensionLinkPayWaitDetailResponse {
@@ -440,7 +295,7 @@ export interface ExtensionLinkPayWaitDetailResponse {
 }

 export interface ExtensionLinkPayWaitDeleteParams extends ExtensionRequestParams {
-  tid: string;
+  requestId: string;
 }

 export interface ExtensionLinkPayWaitDeleteRespone {
--- a/src/entities/additional-service/model/payout/constant.ts
+++ b/src/entities/additional-service/model/payout/constant.ts
@@ -1,8 +1,8 @@
-import { PayoutSearchCl, PayoutDisbursementStatus } from './types';
+import { PayoutSearchDateType, PayoutDisbursementStatus } from './types';

 export const PayoutSearchClBtnGroup = [
-  {name: '요청일자', value: PayoutSearchCl.REQUEST_DATE },
-  {name: '지급일자', value: PayoutSearchCl.PROXY_DATE }
+  {name: '요청일자', value: PayoutSearchDateType.REQUEST_DATE },
+  {name: '지급일자', value: PayoutSearchDateType.SETTLEMENT_DATE }
 ];
 export const PayoutDisbursementStatusBtnGroup = [
  {name: '전체', value: PayoutDisbursementStatus.ALL},
--- a/src/entities/additional-service/model/payout/types.ts
+++ b/src/entities/additional-service/model/payout/types.ts
@@ -7,22 +7,22 @@ export interface ExtensionPayoutRequestParams {
  settlementDate: string;
 };
 export interface ExtensionPayoutRequestResponse {};
-export enum PayoutSearchCl {
+export enum PayoutSearchDateType {
  REQUEST_DATE = 'REQUEST_DATE',
-  PROXY_DATE = 'PROXY_DATE',
+  SETTLEMENT_DATE = 'SETTLEMENT_DATE',
 };
 export enum PayoutDisbursementStatus {
-  ALL = 'ALL',
+  ALL = '',
  REQUEST = 'REQUEST',
  SUCCESS = 'SUCCESS',
  FAIL = 'FAIL',
 };
 export interface ExtensionPayoutListParams {
  mid: string;
-  searchCl: PayoutSearchCl,
+  searchDateType: PayoutSearchDateType,
  fromDate: string;
  toDate: string;
-  disbursementStatus: PayoutDisbursementStatus;
+  status: PayoutDisbursementStatus;
  minAmount?: number;
  maxAmount?: number;
  page?: DefaultRequestPagination;
@@ -54,6 +54,7 @@ export interface ExtensionPayoutDetailResponse {
  transTypeName: string;
  requestDate: string;
  settlementDate: string;
+  settlementDateTime: string;
  companyName: string;
  companyNo: string;
  accountName: string;
@@ -62,6 +63,9 @@ export interface ExtensionPayoutDetailResponse {
  depositName: string;
  failReason: string;
 };
-export interface ExtensionPayoutDetailDownloadCertificateParams extends ExtensionPayoutDetailParams {};
+export interface ExtensionPayoutDetailDownloadCertificateParams extends ExtensionPayoutDetailParams {
+  requestType: string;
+  email: string;
+};

 export interface ExtensionPayoutDetailDownloadCertificateResponse {};