diff --git a/src/api/openapi/api/payment-user-api.ts b/src/api/openapi/api/payment-user-api.ts index df887576..c1fc85d3 100644 --- a/src/api/openapi/api/payment-user-api.ts +++ b/src/api/openapi/api/payment-user-api.ts @@ -266,7 +266,7 @@ export const PaymentUserApiAxiosParamCreator = function (configuration?: Configu }; }, /** - * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |-----------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | + * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |---------------------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | groupStudyDescription | string | 스터디 설명 | | groupStudyImage | string | 스터디 이미지 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | * @summary 유료 스터디 결제 준비 * @param {number} groupStudyId 결제 대상 그룹스터디 ID * @param {StudyPaymentPrepareRequest} studyPaymentPrepareRequest 결제 준비 요청 @@ -381,7 +381,7 @@ export const PaymentUserApiFp = function(configuration?: Configuration) { return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath); }, /** - * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |-----------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | + * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |---------------------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | groupStudyDescription | string | 스터디 설명 | | groupStudyImage | string | 스터디 이미지 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | * @summary 유료 스터디 결제 준비 * @param {number} groupStudyId 결제 대상 그룹스터디 ID * @param {StudyPaymentPrepareRequest} studyPaymentPrepareRequest 결제 준비 요청 @@ -454,7 +454,7 @@ export const PaymentUserApiFactory = function (configuration?: Configuration, ba return localVarFp.getMyTransactionsByGroupStudy(groupStudyId, pageable, page, size, options).then((request) => request(axios, basePath)); }, /** - * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |-----------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | + * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |---------------------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | groupStudyDescription | string | 스터디 설명 | | groupStudyImage | string | 스터디 이미지 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | * @summary 유료 스터디 결제 준비 * @param {number} groupStudyId 결제 대상 그룹스터디 ID * @param {StudyPaymentPrepareRequest} studyPaymentPrepareRequest 결제 준비 요청 @@ -526,7 +526,7 @@ export class PaymentUserApi extends BaseAPI { } /** - * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |-----------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | + * 작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |---------------------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | groupStudyDescription | string | 스터디 설명 | | groupStudyImage | string | 스터디 이미지 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | * @summary 유료 스터디 결제 준비 * @param {number} groupStudyId 결제 대상 그룹스터디 ID * @param {StudyPaymentPrepareRequest} studyPaymentPrepareRequest 결제 준비 요청 diff --git a/src/api/openapi/docs/PaymentUserApi.md b/src/api/openapi/docs/PaymentUserApi.md index 46f30203..0949efe7 100644 --- a/src/api/openapi/docs/PaymentUserApi.md +++ b/src/api/openapi/docs/PaymentUserApi.md @@ -264,7 +264,7 @@ const { status, data } = await apiInstance.getMyTransactionsByGroupStudy( # **preparePayment** > StudyPaymentPrepareResponseSchema preparePayment(studyPaymentPrepareRequest) -작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |-----------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | +작성일자: 2025-12-11 작성자: 이도현 --- ## Description - 유료 스터디 결제를 진행하기 위해 결제 정보를 생성합니다. - 사용자는 이미 신청(PENDING/APPROVED)한 유료 스터디에 대해 결제 페이지로 진입할 때 이 API를 호출합니다. - 서버 기준 스터디 가격(`group_study.price`)과 클라이언트에서 전달한 금액이 다를 경우 결제 준비를 거부합니다. - 동일 회원이 동일 스터디에 대해 SUCCESS 상태 결제를 이미 보유한 경우 재결제를 허용하지 않습니다. --- ## Business Rule - 그룹스터디 조건 - 삭제된 스터디일 경우 결제 불가 - 스터디 상태가 `RECRUITING` 이 아닐 경우 결제 불가 - 무료 스터디(`price == null or 0`)는 결제 불가 - 신청 여부 - 회원이 해당 스터디에 `PENDING` 또는 `APPROVED` 상태로 신청한 기록이 없으면 결제 불가 - 결제 중복 방지 - 동일 회원/스터디 조합에 대해 SUCCESS 결제가 이미 존재하면 에러 --- ## Path Variable | 키 | 타입 | 위치 | 설명 | 필수 | 예시 | |--------------|--------|-------|---------------------|------|------| | groupStudyId | number | path | 결제 대상 스터디 ID | Y | 10 | --- ## Request Body (StudyPaymentPrepareRequest) | 키 | 타입 | 설명 | 필수 | 예시 | |--------|--------|--------------------------------------------------------------|------|-------| | amount | number | 클라이언트에서 인지한 결제 금액 (null 가능, 있을 경우 서버 금액과 일치 검증) | N | 99000 | --- ## Response (StudyPaymentPrepareResponse) | 키 | 타입 | 설명 | |---------------------------|---------|------------------------------------| | paymentId | number | 생성된 결제 ID | | paymentCode | string | 비즈니스용 결제 코드 (PAY-...) | | groupStudyId | number | 스터디 ID | | groupStudyTitle | string | 스터디 제목 | | groupStudyDescription | string | 스터디 설명 | | groupStudyImage | string | 스터디 이미지 | | memberId | number | 결제 회원 ID | | memberName | string | 결제 회원 이름(또는 프로필 이름) | | amount | number | 결제 금액 | | currency | string | 통화 (예: KRW) | | pgProvider | string | PG사 식별자 (예: TOSS) | | tossOrderId | string | 토스 payment orderId (유니크 값) | ### Example