[FEAT] 정산 - 정산 예정 금액 API 및 Payple 정산내역 조회 인프라

[minij02]

✨ 기능 설명

정산관리 화면 대시보드의 "정산 예정 금액"을 표시하기 위한 신규 API와, 향후 환불/취소/검증/리포트에 재사용할 Payple 정산내역 조회 인프라(파트너 인증 + 조회 유틸)를 구현합니다.

✨ 핵심 결정 사항 (확정)

• 정산 예정 금액 = 우리 DB Settlement.status='Pending' 합계 (단순/빠름)
• Payple 정산내역 조회는 내부 유틸로만 추가. 이번 PR엔 외부 endpoint 노출 없음 (향후 검증/스케줄러 재사용)
• PCD_AUTH_KEY 짧은 TTL 캐싱 (Redis, 만료 전 재사용)
• 사용자 노출 API는 DB 합계만 — Payple rate-limit(2분 20회) 무관

✨ 개발 목록

신규 API

• GET /api/settlements/pending-amount — 정산 예정 금액 합계 (SUM(amount) WHERE user_id=? AND status='Pending')
• Swagger

Payple 정산내역 조회 인프라

• utils/payple-settlement.ts 신규
  • 파트너 인증 (PCD_SETTLEMENT_FLAG=Y) — AuthKey 받아 Redis 캐시
  • 정산내역 조회 (PCD_PAY_HOST + PCD_PAY_URL로 호출, PCD_HAS_MORE/PCD_LASTKEY 페이지네이션)
  • 응답 redactor에 PCD_AUTH_KEY/PCD_CUST_KEY 마스킹 추가

Settlement 상태 관리 검증

• 결제 성공 시 Settlement row 생성(status=Pending) → 정산 완료 시 status=Succeed 업데이트 흐름 코드 점검
• 갭이 있으면 별도 이슈로 분리 보고

✨ 기타

• Payple 정산내역 조회 미래 데이터 조회 가능 여부는 명세 불분명 → sandbox 검증 후 가능하면 정산 예정 금액 정확도 보강 (별도 이슈)
• 관련 이슈: [FEAT] 정산 - 판매자 등록 흐름 Payple 명세 정합화 및 보안 개선 #470, [FEAT] 정산 - 판매자 정보 변경 화면 API 및 LEGACY 은행코드 정리 #473, [FEAT] 정산관리 - 정산 계좌 정보 응답에 생년월일 포함 (#473 follow-up) #476