Payster 사용자 매뉴얼
펌뱅킹 이체 관리 시스템 — 사용자 가이드
최종 업데이트: 2026-04-06
1. 시스템 개요
Payster는 본사-대리점-가맹점 3계층 조직 구조 기반의 펌뱅킹 이체/입금/수수료 관리 플랫폼입니다.
역할별 접근 권한
| 역할 | 테마 색상 | 주요 기능 |
|---|---|---|
| 본사 (관리자) | Blue | 전체 관리, 승인, 수수료 정책, 정산, 수금 |
| 대리점 | Emerald | 소속 가맹점 관리, 직접 이체, 수익 조회 |
| 가맹점 | Violet | 이체 요청, 입금 관리, 계좌/원장 조회 |
2. 회원가입 및 로그인
2.1 회원가입
1.로그인 페이지 하단 "대리점 / 가맹점 회원가입" 링크 클릭
2.대리점 또는 가맹점 탭 선택
3.정보 입력:
•기본 정보: 사업자유형(법인/개인/비사업자), 상호명(필수), 사업자번호, 대표자명, 연락처, 이메일, 주소
•로그인 계정: 아이디(영문숫자 4~30자, 중복확인), 비밀번호(8자 이상)
•첨부서류: 사업자등록증, 대표자 신분증, 통장사본 등 (PDF/이미지, 10MB 이하)
4.약관 동의 (필수):
•이용약관: 서비스 이용에 관한 권리/의무 규정 (전문보기 가능)
•개인정보 처리방침: 수집 항목, 이용 목적, 보유 기간 등 안내 (전문보기 가능)
•"전체 동의" 체크박스로 한번에 동의 가능
•약관 미동의 시 가입 신청 불가
5.가입 신청 후 본사 승인 대기 → 승인 완료 후 로그인 가능
가맹점 가입 시 소속 대리점을 선택해야 합니다.
2.2 로그인
•아이디/비밀번호 입력 후 로그인
•역할에 따라 자동으로 해당 페이지로 이동:
•본사 → 대시보드
•대리점 → 대시보드
•가맹점 → 이체 페이지
•로그인 페이지 하단의 프로젝트관리 / 사용자매뉴얼 링크에서 문서를 확인할 수 있습니다.
3. 본사 (관리자) 기능
3.1 대시보드
•전체 KPI 현황: 오늘/이번 달 이체 건수, 금액, 수수료 수익
•대리점별 현황 요약
•수익 추이 확인
3.2 대리점 관리
•대리점 목록 조회 (검색: 상호명, 아이디, 사업자번호)
•대리점 등록/수정:
•기본 정보: 상호명, 사업자번호, 대표자명, 연락처
•PG 설정: PG사 선택(헥토/쿠콘), 상점 ID(MID), 암호화 키, 해시 키
•로그인 계정: 아이디, 비밀번호
•승인 설정:
•실시간이체 승인 필요 (체크박스)
•지정시간이체 승인 필요 (체크박스)
•입금 승인 필요 (체크박스)
•이체 권한: 대리점 이체 권한 부여/해제 (해제 시 대리점 직접 이체 불가)
•수수료 차감방식: 선취(pre_deduct) / 후취(post_billing)
•계정승인 상태 확인 (승인/대기/반려)
3.3 가맹점 관리
•가맹점 목록 조회 (검색: 가맹점명, 아이디, 사업자번호, 대표자, MID)
•가맹점 등록/수정:
•기본 정보: 상호명, 사업자번호, 대표자명, 가상계좌
•이체 한도: 건당/일일/월간 한도
•로그인 계정: 아이디, 비밀번호
•승인 설정:
•실시간이체 승인 필요 (체크박스)
•지정시간이체 승인 필요 (체크박스)
•입금 승인 필요 (체크박스)
•수수료 정책: 수수료 유형(정률/정액/복합), 비율, 건당 금액, 차감방식
•계정승인 상태 확인
3.4 계정 승인 관리
•자가 회원가입 신청 목록
•대리점/가맹점 계정 승인/반려
•본사가 직접 등록한 계정은 즉시 승인 처리
3.5 입금 신청 관리
•가맹점 입금 신청 목록 (전체/승인대기/승인완료/반려/매칭완료 필터)
•개별 승인/반려 처리
•가맹점별 입금 승인 설정 토글 (자동승인/본사승인)
3.6 이체 승인 관리
•본사 승인이 필요한 이체 건 목록 (10초 자동 갱신)
•신규 건 알림: 새로운 이체 승인 요청 접수 시 상단에 알림 배너 표시
•단건 승인/반려 또는 일괄 승인/반려 (체크박스 선택)
•대량이체 그룹 승인: 배치(대량이체) 단위로 그룹 선택 후 일괄 승인 가능
•이체 유형 확인: 실시간 / 지정시간 / 대량이체
•요청자(가맹점/대리점명), 지정시간 표시
3.7 대리점 이체 / 가맹점 이체
•대리점 이체와 가맹점 이체를 별도 메뉴로 분리하여 명확히 구분
•각 페이지에서 해당 유형의 이체 내역만 조회 (기간/상태/유형별 필터)
•요약 카드: 전체 건수, 완료 건수/금액, 대기 건수, 실패 건수, 총 수수료
3.8 전체 현황
•가맹점별 입금/출금 통계 한눈에 확인
•합계 카드 5개: 총 입금(건수), 총 출금(건수), 총 수수료, 가맹점 수, 순이동
•가맹점별 입금건수, 출금건수, 수수료 컬럼 표시
•대리점 필터 드롭다운
3.9 수익 현황
•본사 수수료 수익 현황 (총 수수료, PG 원가, 순 수익)
•대리점별 수익 상세 테이블
•드릴다운: 대리점 행 클릭 → 소속 가맹점별 건별 수수료 상세 표시
3.10 수수료 관리
•수수료 정책 생성/수정/삭제
•정책 추가 시 대리점/가맹점을 드롭다운에서 선택 (아이디 + 상호명 표시)
•수수료 유형:
•정률(percentage): 이체금액의 N%
•정액(per_transaction): 건당 고정 금액
•복합(combined): AND(합산) 또는 OR(최대값)
•수수료 승인 관리 (대리점이 생성한 정책 승인/반려)
•PG 기본수수료(원가) 관리
3.11 계산서 관리
•청구서 생성 (대상, 기간 지정)
•청구서 발행 (draft → issued)
•청구서 상세 조회
3.12 수수료 정산
•일일 자동정산 내역 조회 (매일 00:05 KST 자동 실행)
•날짜/상태별 필터
•실패 건 재시도
•수동 정산 실행 (특정 날짜 지정)
수수료 정산이란? 매일 00:05 KST에 전일 완료된 이체건의 수수료를 가맹점/대리점별로 자동 집계합니다. 후청구 엔티티는 잔액에서 수수료가 차감되며, 수금 계좌가 설정된 경우 PG API를 통해 본사 계좌로 자동 이체됩니다.
3.13 수수료 수금
•수금 현황 탭:
•가맹점별 수수료 보관액(fee_reserve) 현황
•전체 미수금 합계
•체크박스 선택 후 일괄 수금 (PG API로 본사 수금계좌에 자동 이체)
•수수료 집계 탭:
•기간별 입금/이체/성명조회 수수료 건수, 금액
•수금완료/미수금 현황
수수료 수금이란? 선취 방식의 가맹점은 이체/입금/성명조회 시 수수료가 즉시 차감되어 fee_reserve에 누적됩니다. 수금 현황에서 가맹점별 미수금을 확인하고 본사 수금 계좌로 일괄 이체할 수 있습니다.
3.14 설정
•수수료 자동정산 설정: 수금 은행/계좌번호/예금주, 활성화 토글
•서비스 수수료 설정: 입금/이체/성명조회 건당 수수료(포인트), 성명조회 사용여부 토글
4. 대리점 기능
4.1 대시보드
•대리점 KPI: 전체 가맹점, 활성 가맹점, 오늘 입금/출금, 이번 달 순수익
•카드 클릭 시 해당 메뉴로 바로 이동 (가맹점관리/전체현황/이체내역/수익현황)
•최근 이체내역 10건 표시 (유형/은행/예금주/금액/상태/일시)
4.2 대리점 이체
•단건 이체: 은행 선택 → 계좌번호 입력 → 금액/메모 입력 → 이체 실행
•계좌 검증 (PG사별 자동 분기):
•헥토: 예금주 조회 → 예금주명 확인
•쿠콘: 1원 인증 → 인증코드 입력 → 확인
•지정시간 이체: 이체유형을 "지정시간"으로 선택 → 날짜/시간 설정 → 본사 승인 설정에 따라 승인 후 또는 즉시 지정 시간에 자동 실행
•승인 필요 시: 최소 10분 이후 시간부터 선택 가능 (안내 문구 표시)
•승인 불필요 시: 현재 시간 이후 자유롭게 선택 가능
•메모 기본값: 로그인 아이디 자동 입력
•이체 결과 즉시 표시 (성공/실패/처리중)
•처리중(VTIM): 은행 타임아웃 시 자동 결과 폴링 (2분 간격, 최대 10회)
본사에서 대리점 이체 권한을 해제한 경우, 이체가 불가합니다. 본사에 문의하세요.
4.3 대량이체
5단계 위저드:
1.업로드: 엑셀 템플릿 다운로드 → 파일 업로드 (.xlsx, .xls)
2.미리보기: 파싱 결과 확인, 오류 건 표시, 수수료 합계
3.검증: 헥토 — 예금주 자동검증 / 쿠콘 — 검증 생략
•검증 실패 건이 있으면 경고 배너 표시, 이체 실행 불가 → 엑셀 수정 후 재업로드
4.처리중: 진행률 실시간 표시 (2초 폴링)
5.결과: 성공/실패 요약 (5칸: 전체/성공/실패/실이체금액/총수수료) + 건별 상세
본사 승인이 필요한 경우, 승인 후 이체가 실행됩니다.
4.4 대리점 이체 내역
•이체 건별 상세 조회 (기간/상태/유형 필터)
•이체유형: 실시간 / 지정시간 / 대량이체
•실패사유 표시
•처리중 건: "결과확인" 버튼으로 수동 확인 가능
4.5 가맹점 관리
•소속 가맹점 목록 조회
•가맹점 등록/수정
•수수료 정책 관리
4.6 가맹점 이체 현황
•소속 가맹점 이체 현황 조회
4.7 가맹점 입출금 현황
•소속 가맹점별 종합 통계
•합계 카드: 총 입금/총 출금/총 수수료/가맹점 수/순이동
•가맹점별 입금건수, 출금건수, 수수료 컬럼 표시
4.8 본사 수수료 제안
•가맹점별 수수료 정책 생성/수정
•본사 승인 필요 (생성 후 승인 대기)
4.9 수익현황
•대리점 수수료 수익 현황 (총 수수료 수입, 본사 지급 수수료, 자체 이체 수수료, 순수익)
•건별 수수료 상세: 가맹점별 이체건 수수료 내역 테이블 (가맹점명/유형/금액/수수료/본사수수료/대리점수익/일시)
•수익 구조 요약 (수입 - 지급 = 순수익)
4.10 계산서 조회
•발행된 청구서 목록 조회
4.11 자주쓰는 계좌
•계좌 등록/수정/삭제
•이체 시 즐겨찾기에서 빠르게 선택
4.12 보내는 사람
•보내는사람 성명 관리 (등록/삭제)
•이체 시 보내는사람 선택
5. 가맹점 기능
5.1 입금 신청
•입금 예정 금액, 보내는사람 입력 → 신청
•본사 승인 필요 시: 승인 대기 → 승인 후 입금 가능
•자동 승인 시: 즉시 입금 가능
•승인 상태 안내 배너 표시
•승인 후 다음 단계: 가상계좌로 실제 입금 → 입금 대사에서 확인
•pending 건이 있으면 10초 간격 자동 갱신
5.2 입금내역
•입금 건별 조회 (기간 필터)
•입금일, 입금시간, 금액, 입금자, 매칭상태 표시
5.3 입금 대사
•탭 2개: "입금 대사" 탭 + "입금내역" 탭 통합
•입금 대사 탭: 입금 신청(DepositRequest)과 실제 입금(Deposit) 매칭 확인
•자동 매칭: 금액/보내는사람 일치 시 자동 매칭
•수동 매칭: 불일치 건 수동 연결
•상태 카드 4개: 전체/매칭완료/미매칭신청/미매칭입금 (클릭 시 필터링)
•입금내역 탭: 입금내역 페이지와 동일한 조회 기능 제공
입금 대사란? 입금 신청과 실제 PG사를 통해 들어온 입금을 매칭하여 확인하는 기능입니다. 입금 신청 후 가상계좌로 실제 입금하면 자동으로 매칭되며, 금액이나 보내는분이 다를 경우 수동 매칭이 필요합니다.
5.4 펌뱅킹 이체
•단건 이체: 은행 선택 → 계좌번호 → 금액/메모 → 이체
•계좌 검증:
•헥토: "예금주 인증" 버튼 → 예금주명 자동 확인
•쿠콘: "인증 요청" → 1원 입금 → 인증코드 입력 → "인증 확인"
•성명조회 사용여부는 본사 설정에 따름 (미사용 시 버튼 숨김)
•지정시간 이체: 날짜/시간 지정 → 본사 승인 설정에 따라 승인 후 또는 즉시 자동 실행
•승인 필요 시: 최소 10분 이후 시간부터 선택 가능 (안내 문구 표시)
•승인 불필요 시: 현재 시간 이후 자유롭게 선택 가능
•수수료 안내: 이체 수수료, 성명조회 수수료 표시 (포인트 단위)
•이체 결과 즉시 표시 (처리중인 경우 자동 폴링)
5.5 대량이체
•대리점과 동일한 5단계 위저드
•엑셀 템플릿 다운로드 → 작성 → 업로드 → 검증 → 이체 실행
5.6 이체내역
•이체 건별 조회 (기간/상태/유형 필터)
•요약 카드: 총 이체건수 / 총 이체금액 / 총 수수료 / 승인대기 건수
•이체유형: 실시간 / 지정시간 / 대량이체
•실패사유 표시
•처리중 건: "결과확인" 버튼
5.7 입출금 현황
•모든 거래 내역 조회 (입금/출금/수수료)
•거래 유형별 필터:
•입금(deposit), 출금(withdraw)
•입금수수료(deposit_fee), 이체수수료(transfer_fee), 성명조회수수료(name_check_fee)
•잔액 변동 추적 (거래 전/후 잔액)
5.8 자주쓰는 계좌
•은행/계좌번호/별칭으로 계좌 등록
•수정/삭제 가능
•이체 시 즐겨찾기에서 빠른 선택
5.9 보내는사람 관리
•보내는사람 성명 등록/삭제
•이체 시 선택 가능
5.10 설정
•프로필 정보 조회/수정
•비밀번호 변경
6. 수수료 체계
6.1 수수료 구조
PG 기본수수료 (원가)
→ 본사 수수료 (HQ → 대리점)
→ 대리점 수수료 (대리점 → 가맹점)
→ 가맹점 부담 = 총 수수료
6.2 수수료 유형
| 유형 | 설명 | 예시 |
|---|---|---|
| 정률 (percentage) | 이체금액의 N% | 0.5% → 100만원 이체 시 5,000포인트 |
| 정액 (per_transaction) | 건당 고정 금액 | 건당 500포인트 |
| 복합 (combined) | AND(합산) 또는 OR(최대값) | AND: 0.1% + 300포인트 / OR: max(0.1%, 300포인트) |
6.3 수수료 단위
| 구분 | 단위 |
|---|---|
| 수수료 설정/표시 | 포인트 |
| 수수료 수금(fee_reserve) | 포인트 |
| 이체/입금 실거래 금액 | 원 |
| 잔액/입출금 내역 | 원 |
6.4 차감 방식
| 방식 | 설명 |
|---|---|
| 선취 (pre_deduct) | 거래 시 즉시 잔액에서 수수료 차감, fee_reserve에 누적 |
| 후취 (post_billing) | 거래 시 수수료 미차감, 일일 정산 시 일괄 처리 |
6.5 서비스 수수료
본사가 설정하는 건당 서비스 수수료:
| 수수료 종류 | 적용 시점 |
|---|---|
| 입금 수수료 | PG사 입금 노티 수신 시 자동 적용 |
| 이체 수수료 | 이체 성공 시 적용 |
| 성명조회 수수료 | 예금주 조회 시 적용 (사용여부 설정 가능) |
7. 이체 처리 흐름
7.1 단건 이체
이체 요청 → 한도 체크 (건당/일일/월간)
→ 수수료 자동 계산
→ 본사 승인 필요? → 예: 승인 대기 / 아니오: 즉시 실행
→ PG API 호출 → 결과 수신
→ 성공: 원장 기록 + 수수료 적용
→ VTIM(타임아웃): 자동 폴링 (2분 간격, 최대 10회)
→ 실패: 실패 사유 표시
7.2 지정시간 이체
이체 예약 (미래 시간 지정) → 본사 승인 설정에 따라 승인 대기 또는 즉시 예약
→ (승인 필요 시) 최소 10분 이후 시간만 선택 가능 → 본사 승인 → 지정 시간 도래 시 자동 실행 (1분 간격 체크)
→ (승인 불필요 시) 현재 시간 이후 자유 선택 → 지정 시간 도래 시 바로 자동 실행
7.3 대량이체
엑셀 업로드 → 미리보기 → 검증 → (본사 승인) → 이체 실행 → 결과 확인
8. 입금 처리 흐름
가맹점 입금 신청 → (본사 승인 필요 시) 본사 승인
→ 가상계좌로 실제 입금
→ PG사 콜백 → 입금 기록 생성
→ 입금 대사에서 자동/수동 매칭 확인
9. 계좌 검증 방식
헥토 (예금주 조회)
1.은행/계좌번호 입력
2."예금주 인증" 버튼 클릭
3.예금주명 자동 확인 → 일치 시 이체 가능
쿠콘 (1원 계좌검증)
1.은행/계좌번호 입력
2."인증 요청" 클릭 → 해당 계좌에 1원 입금 (입금자명에 인증코드 포함)
3.인증코드 입력 → "인증 확인" 클릭
4.인증 완료 → 이체 가능
10. PG 연동 정보
헥토파이낸셜 (간편현금결제 API)
| 항목 | 값 |
|---|---|
| API 도메인 | npay.settlebank.co.kr |
| 기관코드(MID) | M2474526 |
| 입금 가상계좌 | 케이뱅크 70166000001222 |
| 기능 | API | 설명 |
|---|---|---|
| 송금 | /v1/api/pay/rmt | 펌뱅킹 이체 실행 |
| 잔액조회 | /v2/api/pay/rmt/blc | 송금계좌 잔액 확인 |
| 결과조회 | /v1/api/pay/morw | VTIM(타임아웃) 시 이체 결과 확인 |
| 예금주조회 | /v1/api/auth/acnt/ownercheck1 | 계좌 예금주 성명 조회 |
•개인정보 암호화: AES-256/ECB/PKCS5Padding + Base64
•위변조 방지: SHA-256 해시 검증
•통신: HTTPS (TLS 1.2 이상)
쿠콘 (입금이체 PG API)
| 항목 | 값 |
|---|---|
| API 도메인 (운영) | apigw.coocon.co.kr |
| API 도메인 (개발) | dev2.coocon.co.kr:8443 |
| API 경로 | /sol/gateway/vapg_wapi.jsp (단일 URL, KEY로 구분) |
| 기능 | KEY | 설명 |
|---|---|---|
| 예금주명 조회 | 6110 | 송금 대상 계좌의 예금주명 조회 (TRSC_AMT 1원 이상 필수) |
| 입금이체 | 6120 | 입금이체 요청 (WDRW_ACCT_NO 출금계좌 필수) |
| 처리결과 조회 | 6170 | 타임아웃 시 이체 결과 확인 (STS: 1=정상/3=오류/6=처리중) |
| 잔액조회 | 6140 | 출금계좌 잔액 확인 (송금가능잔액/정지금액 분리) |
쿠콘 Checkpay (1원 계좌검증)
| 항목 | 값 |
|---|---|
| 개발 URL | dev.checkpay.co.kr |
| 운영 URL | www.checkpay.co.kr |
| 암호화 | AES-256/CBC/PKCS5Padding + HMAC-SHA256 |
| 기능 | API | 설명 |
|---|---|---|
| 계좌검증 요청 | CPIF_AFFL_720.jct | 1원 입금 + 인증코드 전송 |
| 계좌검증 확인 | CPIF_AFFL_721.jct | 인증코드 검증 |
| 처리결과 조회 | CPIF_AFFL_722.jct | 타임아웃 시 결과 확인 |
11. 운영 정보
•운영시간: 평일 09:00 ~ 18:00 (주말 및 공휴일 휴무)
•접속 URL: wallet.payster.co.kr
•자동 정산: 매일 00:05 KST 전일 수수료 자동 집계/정산
•VTIM 자동 폴링: 2분 간격, 최대 10회 (약 20분)
•PG 연동: 헥토파이낸셜 간편현금결제 API (운영: npay.settlebank.co.kr) + 쿠콘 입금이체 PG API (운영: apigw.coocon.co.kr)
12. 이체 한도 (현재 테스트 설정)
※ 실거래 테스트 기간 중 안전을 위해 축소 설정되어 있습니다. 운영 전환 시 복원 필요.
| 항목 | 한도 |
|---|---|
| 건당 이체 한도 | 5,000원 |
| 일일 이체 한도 | 100,000원 |
| 월간 이체 한도 | 100,000원 |
13. 주의사항
•지정시간 이체는 현재 시간 이후로만 설정 가능 (승인 필요 시 최소 10분 이후)
•대량이체 검증 실패 건이 있으면 전체 재업로드 필요 (부분 이체 불가)
•수수료는 포인트 단위, 실거래 금액은 원 단위
•선취 수수료는 거래 즉시 차감되며, fee_reserve에 누적
•파일 업로드: PDF, 이미지, 문서 파일만 가능 (최대 10MB)
•본사에서 대리점 이체 권한을 해제하면 해당 대리점은 이체 불가
•지정시간이체 승인 설정은 실시간이체 승인과 별도로 관리됨
•이체 처리중(VTIM) 상태 건은 자동 결과 확인 후 완료/실패 처리됨 (수동 확인도 가능)