2.1 KiB
2.1 KiB
레거시 결제 처리 전환 계약 문서
1. 입력 계약
- 고객 요청 정보
사용자 ID: 고객을 식별하는 고유한 값결제 금액: 고객이 결제하고자 하는 금액결제 방법: 카드, 송금, 기타
2. 출력 계약
- 결제 처리 결과
결제 상태: 성공, 실패오류 코드: 결제 실패 시 오류를 설명하는 코드(예: 101, 102)거래 ID: 결제 거래의 고유 식별자
3. 트랜잭션 경계
- 시작: 사용자가 결제 요청을 제출할 때
- 종료: 결제가 성공적으로 처리되거나 오류가 발생하여 롤백 될 때
4. 오류 매핑
| 오류 코드 | 오류 설명 | 해결 방법 |
|---|---|---|
| 101 | 결제 금액 부족 | 금액을 확인 후 재시도 |
| 102 | 카드 정보 오류 | 카드 정보를 다시 확인하기 |
| 103 | 시스템 오류 | 고객 지원에 문의 |
5. 외부 연동
- 결제 Gateway 연동
- 결제 Gateway API를 호출하여 결제를 처리
- 사용자 인증 및 결제 정보를 API에 전달
- 고객 알림 서비스 연동
- 결제 결과를 고객에게 SMS/이메일로 통지
6. Spring service/repository 매핑
- Service Layer
PaymentService: 결제 처리를 담당- 메서드:
processPayment(request: PaymentRequest): PaymentResponse
- 메서드:
- Repository Layer
PaymentRepository: 결제 정보를 DB에 저장- 메서드:
save(payment: Payment): void
- 메서드:
7. 검증 체크리스트
- 입력 값이 유효한지 확인
- 결제 금액이 0보다 큰지 확인
- 결제 방법이 지원되는지 확인
- 외부 API 호출 전후에 예외 처리 확인
- 결제 처리 내역이 DB에 정상 저장되는지 확인
명확하지 않은 가정
- 고객 요청 정보의 모든 필드는 필수로 제공된다고 가정함
- 결제 처리 중 발생할 수 있는 각 오류에 대한 구체적인 대응 방안은 추후 논의 필요