Express KG이니시스 Return Server

이 프로젝트는 KG이니시스 표준 결제 연동 과정에서 결제창 호출 및 결제 승인 처리만을 담당하는 경량화된 Express 서버입니다.
DB 연결 없이 승인 정보만 검증한 뒤, 메인 API 서버로 결과를 전달하고, 클라이언트(Svelte)로 안전하게 리디렉션합니다.

프로젝트 구조

- views
   - INIstdpay_pc_req.ejs        // KG이니시스 결제창 호출용 템플릿
- .env                           // 환경 변수 설정 파일
- express-return-server.js       // 메인 서버 로직
- package-lock.json
- package.json
- properties.js                  // IDC에 따른 승인/망취소 URL 설정 유틸

주요 기능

1. /start-payment

• 클라이언트(Svelte)에서 이니시스 결제 정보를 POST
• 전달받은 정보로 INIstdpay_pc_req.ejs 템플릿을 렌더링하여 KG이니시스 결제창을 호출

2. /return

• KG이니시스에서 결제 결과를 POST
• resultCode === "0000"이면 승인 요청 수행
• 승인 성공 시:
  • ASP.NET Core API 서버의 /order/approve 엔드포인트에 승인 결과 전송 (X-INTERNAL-SECRET 포함)
  • 이후 클라이언트로 리디렉션 (/return?resultCode=...&moid=...)
• 실패 또는 예외 발생 시:
  • netCancelUrl로 망취소 요청 시도
  • 클라이언트로 실패 코드 리디렉션

보안 처리

• 서버 간 인증: API 서버 호출 시 X-INTERNAL-SECRET 헤더 포함
• SignKey 보호: .env 파일에 보관, SHA256 해시 처리 후 승인 요청
• Express는 직접 DB에 접근하지 않음

.env 설정 예시

API_SECRET=552FFF9E8CA58233D54ADC6CDC85F3B2D126F26830D5713F567E65D138C108BB
SIGN_KEY=SU5JTElURV9UUklQTEVERVNfS0VZU1RS
API_URL=https://localhost:7102
SVELTE_URL=http://localhost:5173

실행 방법

npm install
node server.js

의존 패키지

• express
• dotenv
• ejs
• request
• crypto
• path

연동 흐름 요약

[Svelte]
  ↓ POST
/start-payment
  ↓
[Express] → 이니시스 결제창 호출 (ejs 렌더링)
  ↓
[User completes payment on 이니시스]
  ↓
/return (POST from 이니시스)
  ↓
[Express 승인 요청 → 이니시스]
  ↓
[성공 시 API 서버 /order/approve 호출 (with X-INTERNAL-SECRET)]
  ↓
[Svelte 리디렉션 /return?resultCode=0000&moid=...]

기여 및 테스트

• 이 서버는 프론트엔드와 백엔드 사이의 결제 브리지 역할만 수행합니다.
• 확장 또는 테스트는 클라이언트/서버 양쪽에서 환경 설정을 일치시켜야 합니다.