하이패스 영수증 발급

What this skill does

https://www.hipass.co.kr

• 사용내역 조회
• 특정 행 선택
• 영수증 팝업/출력 화면 진입
• 세션 만료 감지 후 재로그인 안내

Hard limits

• 로그인은 반드시 사용자가 직접 해야 한다.
• 이 스킬은 로그인된 세션에서만 동작한다.
• ID/PW, 인증코드, OTP, 공동인증서 절차를 자동 입력하지 않는다.

• JSESSIONID

  쿠키만 저장해 장시간 재사용하는 방식은 지원하지 않는다.
• 권장 세션 형태는 Playwright persistent context 또는 Chrome

  user-data-dir

  / remote-debugging 재사용이다.
• 세션이 만료되면 즉시 중단하고 다시 로그인해야 한다.

Why this design

• 로그인 페이지와 메인 페이지에

  session_time=1200

  이 노출된다.
• 세션 연장은

  /comm/sessionCheck.do

• 세션 종료는

  /comm//sessionout.do

• 미로그인/세션 종료 보호 응답은

  mgs_type 11/12

  후

  /comm/lginpg.do

  로 이동한다.
• 사용내역 조회는

  /usepculr/InitUsePculrTabSearch.do

  →

  hpForm

  submit →

  /usepculr/UsePculrTabSearchList.do

  흐름이다.
• 영수증은

  /usepculr/UsePculrReceiptPrint.do

  팝업 진입으로 이어진다.

Prerequisites

• macOS 또는 Chrome 실행 가능한 환경

• npm install hipass-receipt

  또는 이 레포에서

  npm install

  (

  playwright-core

  포함)
• Chrome 원격 디버깅 포트 사용 가능
• 사용자가 직접 하이패스 로그인 가능

Workflow

1. 전용 Chrome 프로필로 로그인 브라우저를 띄운다

hipass-receipt chrome-command --profile-dir "$HOME/.cache/k-skill/hipass-chrome" --debugging-port 9222

https://www.hipass.co.kr/comm/lginpg.do

2. 사용내역을 조회한다

hipass-receipt list \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --page-size 30

• 카드사/암호화 카드번호를 알고 있으면

  --encrypted-card-number

  등으로 더 좁힐 수 있다.

• --encrypted-card-number

  는 CLI의 기존

  --ecd-no

  별칭이다.
• 결과 JSON에서

  rowIndex

  를 확인한다.

3. 특정 row의 영수증 팝업을 연다

hipass-receipt receipt \
  --cdp-url http://127.0.0.1:9222 \
  --start-date 2026-04-01 \
  --end-date 2026-04-07 \
  --row-index 1

• 선택한 행의

  영수증

  /

  출력

  control 을 클릭한다.
• 팝업이 열리면 URL/title 을 반환한다.

Response policy

• “로그인 필수”, “세션 만료 시 재로그인 필요”를 항상 명확히 적는다.
• 하이패스 계정 비밀번호를 받아 저장하거나 새 env var를 만들지 않는다.
• 세션이 만료됐으면 즉시 실패시키고

  /comm/lginpg.do

  재로그인만 안내한다.
• v1 범위를 넘어서는 완전 무인 로그인 유지/백그라운드 재인증은 약속하지 않는다.

Verification

• 자동 검증: fixture 기반 query/parser/session-detection 테스트
• smoke 검증:

  hipass-receipt fixture-demo --fixture ...

• 최종 실서비스 검증: 로그인된 세션으로 수동 smoke test

Done when

• 로그인된 세션으로 사용내역 조회가 가능하다.
• 특정 row를 선택해 영수증 팝업 진입을 시도할 수 있다.
• 세션 종료 응답을 감지하면 재로그인을 요구한다.