코프링 멀티모듈 아임포트 결제모듈 토이프로젝트

• JDK 17
• SpringBoot: 3.0.5
• kotlinVersion: 1.7.22

모듈 구성

• escro-payment-front
  • payment-front-api
    • SpringBoot + Kotlin
  • payment-front-ui
    • Vue3 + TypeScript + Vite
• customer-api
• order-api
• payment-api
• product-api
  • SpringBoot + Kotlin
• customer-rds-entity
• order-rds-entity
• payment-rds-entity
• product-rds-entity
  • SpringBoot + Kotlin
  • MySQL
• common
  • SpringBoot + Kotlin
• buildSrc
  • Project Library and Version Management

아임포트의 에스크로 결제 기능을 이용해 구매자와 판매자 간의 안전한 거래를 지원하는 토이 프로젝트.

1. 회원 가입 및 로그인 기능
2. 상품 등록 및 조회 기능
3. 에스크로 결제 요청
4. 에스크로 결제 확인 및 승인
5. 에스크로 환불 및 취소

1. POST /auth/signup

• 요청: 이메일, 비밀번호, 이름 등 회원 정보
• 응답: 성공 여부, 메시지

2. POST /auth/login

• 요청: 이메일, 비밀번호
• 응답: 성공 여부, 메시지, JWT 토큰

1. POST /products

• 요청: 상품명, 상품 설명, 가격, 재고 수
• 응답: 성공 여부, 메시지, 상품 ID

2. PUT /products/{productId}

• 요청 : 상품명, 상품 설명, 가격, 재고 수
• 응답 : 성공 여부, 메시지

3. GET /products

• 요청: 없음
• 응답: 상품 리스트

1. POST /payments

• 요청: 상품 ID, 구매자 ID, 판매자 ID, 가격, 에스크로 옵션 활성화
• 응답: 아임포트 결제 ID, 에스크로 결제 정보

1. GET /payments/{paymentId}/status

• 요청: 결제 ID
• 응답: 결제 상태, 결제 정보

2. POST /payments/{paymentId}/confirm

• 요청: 결제 ID
• 응답: 성공 여부, 메시지

1. POST /payments/{paymentId}/refund

• 요청: 결제 ID, 환불 사유
• 응답: 성공 여부, 메시지

2. POST /payments/{paymentId}/cancel

• 요청: 결제 ID
• 응답: 성공 여부, 메시지

• users (1:N) orders
• users (1:N) payments
• products (1:N) order_items
• products (N:M) products
• orders (1:N) order_items
• orders (1:1) payments

• 주문 생성(on-order-create_order-create : {productId, orderId, userId, createdAt}) > 결제(on-order-create_payment-create : {paymentId, orderId, productId, userId, createdAt}) > 주문 생성(on-order-create_order-create : {paymentId, productId, orderId, userId, createdAt}) > 상품 재고 변경(on-order-create_product-stock-change : {에스크로 관련 정보}) > 배송(SKIP) > 에스크로 주문 확정(on-order-create_escrow-order-confirmation) > 주문 확정(on-order-create_order-confirm 주문 확정 : {paymentId, productId, orderId, userId, createdAt})
• 주문 취소(on-order-cancel_order-cancel) > 결제 취소(on-order-cancel_payment-cancel) > 상품 재고 변경(on-order-cancel_product-stock-change) > 주문 확정(on-order-cancel_order-confirm 주문 취소 확정 : {paymentId, productId, orderId, userId, createdAt})

https://developers.portone.io/docs/ko/readme

• ISP 결제 : 공개키 기반의 전자인증서를 통해 사전에 등록된 카드정보를 인증하는 방식
• MPI 결제 : 카드번호, CVC, 안심클릭 비밀번호를 입력하여 카드정보를 인증하는 방식

• KG이니시스
• NHN KCP
• 페이조아(다우테이타)
• 스마트로-신모듈

https://developers.portone.io/docs/ko/api/api

https://developers.portone.io/docs/ko/auth/guide/1

https://developers.portone.io/docs/ko/result/webhook

https://developers.portone.io/docs/ko/auth/guide-2/readme

고려할 사항 상품 배송비 재고 등등... 포인트, 쿠폰 등은 일정상 가능하다면 추가

• 회원 가입 - POST /auth/signup

• 로그인 - POST /auth/login

• 상품 등록 - POST /products

• 상품 수정 - PUT /products/{productId}

• 상품 조회 - GET /products

• 주문 생성 (배송완료까지) - POST /orders

• 주문 확정 - POST /orders/{orderId}/confirm

• 주문 취소 - DELETE /orders/{orderId}/cancel

• 에스크로 결제 요청 - POST /payments

• 에스크로 환불 - POST /payments/{paymentId}/refund
• 에스크로 취소 - POST /payments/{paymentId}/cancel

• 참고 - https://everydayyy.tistory.com/89

• 

• 프론트 - js 라이브러리 추가

• 백엔드 - gradle 아임포트 SDK 추가

• 백엔드 - 검증 API 호출 (프론트에서 값 전달 : /verifyIamport/{imp_uid})

• 백엔드 - 배송정보 유효성 검증

• 백엔드 - 결제 성공시에 작동하는 주문 비즈니스 로직

• 백엔드 이벤트 - 결제 성공
  배송객체 생성
  주문객체 생성, delivery와 매핑
  주문아이템 객체 생성, order와 매핑
  장바구니사용자라면 구매한 장바구니 객체 삭제

• 배송완료 이벤트 발행

• 에스크로 배송 완료 후 n일 || 주문 확정 / 주문 교환,취소 ? 입금 : return

기초 개념 > https://erjuer.tistory.com/91 https://velog.io/@zenon8485/Spring-Cloud-Stream-%EC%A0%95%EB%A6%AC https://www.devkuma.com/docs/apache-kafka/strems/ https://www.techblogss.com/springboot/spring-boot-kafka-streams-example https://www.youtube.com/watch?v=u8QMyXlq8Po 뭔지 몰라도 취소선 있는데 사용중... 공부 좀더 해보는걸

• 야근 시렁... 힝...