📚 NEXVA P2P 공식 문서

NEXVA P2P
사용자 매뉴얼

P2P 상품권 거래 플랫폼의 모든 기능을 상세하게 안내합니다.
회원가입부터 상품권 구매, 판매, 선물, QR결제까지 한 번에 확인하세요.

📅 2026년 4월 7일 📱 v1.6.3 📝 프론트엔드 사용자 가이드

📋 목차

1
로그인
앱에 접속하기 위한 첫 번째 단계

🔒 로그인 화면

/login
로그인 화면

NEXVA P2P 플랫폼에 접속하기 위한 로그인 화면입니다. 그라데이션 블루 배너와 함께 깔끔한 인증 폼이 제공됩니다.

  • 👤
    아이디 입력 — 가입 시 등록한 아이디를 입력합니다. 메일 아이콘이 왼쪽에 표시됩니다.
  • 🔐
    비밀번호 입력 — 비밀번호를 입력합니다. 자물쇠 아이콘이 왼쪽에 표시됩니다.
  • 💾
    아이디 저장 — 체크박스를 선택하면 다음 접속 시 아이디가 자동으로 입력됩니다.
  • 🔗
    비밀번호 찾기 — 비밀번호를 잊은 경우 오른쪽의 링크를 통해 재설정할 수 있습니다.
  • 로그인 버튼 — 블루 그라데이션 버튼을 눌러 로그인합니다. 인증 중에는 로딩 스피너가 표시됩니다.
  • 🖊
    회원가입 링크 — 계정이 없으면 하단의 "회원가입" 링크를 눌러 가입 페이지로 이동합니다.
💡
팁: 로그인 후에는 자동으로 홈 화면으로 이동합니다. 세션이 유지되므로 앱을 다시 열 때 별도 로그인 없이 바로 이용할 수 있습니다.
2
회원가입
3단계 인증을 통한 안전한 회원 등록

✨ 회원가입 화면

/register
회원가입 상단
회원가입 중간
회원가입 하단

NEXVA P2P에 가입하기 위한 페이지입니다. 기본 정보 입력, 휴대폰 인증, 계좌 1원 인증의 3단계를 거칩니다.

기본 정보 입력

이름, 아이디, 이메일(선택), 비밀번호, 비밀번호 확인을 입력합니다. 비밀번호는 8자 이상이어야 합니다.

휴대폰 인증

전화번호를 입력하고 인증번호 발송 버튼을 눌러 SMS로 6자리 인증코드를 받습니다. 코드 입력 후 인증이 완료되면 녹색 체크 아이콘이 표시됩니다.

은행 계좌 1원 인증

은행명, 계좌번호, 예금주를 입력하고 계좌 1원 인증 버튼을 누릅니다. 계좌에 1원이 입금되며, 입금 메모에 포함된 4자리 코드를 입력하면 인증이 완료됩니다.

추천 코드 입력 (선택)

가맹점 추천 코드가 있으면 입력합니다. (예: MC-004) 실시간으로 유효 여부가 확인됩니다.

⚠️
주의: 휴대폰 인증과 계좌 1원 인증이 모두 완료되어야 가입 버튼이 활성화됩니다. 본인 명의의 휴대폰과 계좌만 사용해주세요.
3
비밀번호 찾기
3단계 인증을 통한 비밀번호 재설정

🔑 비밀번호 찾기 화면

/forgot-password

비밀번호를 잊어버린 경우 등록된 전화번호를 통해 새 비밀번호를 설정할 수 있습니다.

📱 전화번호 입력
🔑 인증코드 입력
🔒 새 비밀번호 설정
  • 1
    Step 1 — 전화번호 입력: 가입 시 등록한 전화번호를 입력하고 "인증코드 발송" 버튼을 누릅니다.
  • 2
    Step 2 — 인증코드 입력: SMS로 받은 6자리 인증코드를 입력합니다. 재발송 버튼도 제공됩니다.
  • 3
    Step 3 — 새 비밀번호 설정: 새 비밀번호와 확인 비밀번호를 입력하여 비밀번호를 재설정합니다.

상단에 3단계 진행률 바가 표시되어 현재 단계를 쉽게 확인할 수 있습니다.

4
홈 / 대시보드
모든 핵심 기능에 빠르게 접근하는 메인 화면

🏠 홈 화면 구성

/home
홈 화면 상단
홈 화면 하단

로그인 후 가장 먼저 보이는 메인 대시보드입니다. 잔액, 빠른 메뉴, 서비스 메뉴, 최근 거래를 한눈에 확인할 수 있습니다.

① 상단 인사말 영역

  • 👋
    인사말: "안녕하세요" + 사용자 이름이 크게 표시됩니다.
  • 🔔
    알림 아이콘: 우측 상단의 종 아이콘을 누르면 알림 페이지로 이동합니다. 읽지 않은 알림이 있으면 빨간 배지가 표시됩니다.

② 상품권 잔액 카드

보라색~분홍색 그라데이션 배경의 잔액 카드가 표시됩니다.

  • 💳
    잔액 표시: "상품권 잔액" 라벨과 함께 보유 금액이 크게 표시됩니다. (예: 140,000원)
  • 🃏
    보유 수량: "보유 9장" 형태로 현재 보유한 상품권 수가 표시됩니다. 탭하면 내 상품권 페이지로 이동합니다.

③ 빠른 액션 (4개 아이콘)

📡 QR결제

가맹점 QR코드를 스캔하여 상품권으로 결제합니다.

🛒 구매

다른 사용자에게서 상품권을 P2P로 구매합니다.

📤 판매

보유한 상품권을 P2P로 판매합니다.

🎁 선물

다른 사용자에게 상품권을 선물합니다.

④ 서비스 메뉴 (3x2 그리드)

💳 내 상품권

보유 상품권 목록을 확인하고 관리합니다.

🎫 사용 신청

상품권 사용(환급)을 신청합니다.

📡 QR내역

QR 결제 이력을 확인합니다.

📋 거래 내역

P2P 구매/판매 거래 이력을 확인합니다.

🎁 선물 내역

보낸/받은 선물 이력을 확인합니다.

💬 고객센터

관리자에게 1:1 채팅으로 문의합니다.

⑤ 처리 필요 거래 (조건부 표시)

진행 중인 거래가 있을 때 홈 화면에 액션 카드가 나타납니다.

  • 💵
    입금 필요 (구매자): 파란색 왼쪽 보더 카드. 거래번호, 권면가, 입금 금액이 표시되며, 탭하면 거래 상세로 이동합니다.
  • 입금확인 필요 (판매자): 주황색 왼쪽 보더 카드. 금액, 구매자 이름, "입금완료" 상태가 표시되며, 확정 버튼으로 입금을 확정합니다.

⑥ 최근 거래

최근 5건의 P2P 거래가 표시됩니다. 각 항목에는 거래 유형(구/판), 상품권명, 권면가, 날짜, 거래가, 상태 배지가 포함됩니다. "전체 >" 링크로 전체 내역을 볼 수 있습니다.

5
상품권 구매
P2P 매칭을 통한 상품권 구매 프로세스

🛒 구매 화면

/p2p/buy
구매 화면

다른 사용자의 상품권을 P2P 방식으로 구매합니다. 상품권 종류와 금액을 선택한 후 매칭을 기다립니다.

상품권 종류 선택 (필수)

드롭다운을 눌러 구매할 상품권 브랜드를 선택합니다. (예: 신세계상품권, 롯데상품권 등) 빨간색 필수 배지가 표시됩니다.

구매 금액 입력

금액을 직접 입력하거나 프리셋 버튼(+1만, +3만, +5만, +10만, +30만, +50만)을 눌러 빠르게 설정합니다. 최소 금액은 1,000원입니다.

거래 이용 서약 동의

"거래 이용 서약" 섹션을 펼쳐 이용약관을 확인하고, 동의 체크박스를 선택합니다.

구매 등록 및 매칭 대기

하단의 블루 "○○원 구매 등록" 버튼을 누르면 매칭 오버레이가 나타나고 판매자와 매칭을 기다립니다.

매칭 오버레이: 구매 등록 후 전체화면 오버레이가 표시됩니다.
  • 남은 대기 시간(MM:SS) 카운트다운
  • "구매자를 찾고 있습니다..." 상태 메시지 (애니메이션 점)
  • 매칭 진행률 바
  • "백그라운드로 진행" 버튼 — 홈으로 돌아가면서 백그라운드에서 매칭 계속
  • "구매 취소" 버튼

매칭 완료 후 입금 프로세스

매칭이 완료되면 판매자의 계좌 정보가 표시됩니다.

  • 🏦
    은행명 / 계좌번호 / 예금주: 판매자 입금 계좌 정보가 표시됩니다. 계좌번호 옆 복사 버튼으로 클립보드에 복사 가능합니다.
  • 💵
    입금 금액: 파란색 큰 글씨로 입금해야 할 금액이 표시됩니다.
  • 📣
    입금 완료 알리기 버튼: 실제 입금 후 이 버튼을 눌러 판매자에게 입금 사실을 알립니다.
⚠️
구매 안내:
  • 판매자 매칭 대기: 최대 1분
  • 매칭 후 판매자 계좌로 직접 입금
  • 판매자 입금 확인 후 상품권이 지급됩니다
6
상품권 판매
보유 상품권을 선택하여 P2P 판매

📤 판매 화면

/p2p/sell
판매 화면

보유한 상품권을 선택하여 P2P 방식으로 판매합니다. 구매자와 매칭되면 입금을 확인하고 거래를 완료합니다.

판매할 상품권 선택

보유 상품권 목록에서 판매할 상품권을 체크합니다. "전체 선택" 버튼으로 한번에 선택할 수 있습니다. 선택하면 파란색 체크와 테두리로 강조됩니다.

수금 방법 선택

2가지 수금 방법 중 하나를 선택합니다.

판매 등록 및 매칭 대기

하단 버튼을 누르면 구매자 매칭 대기 화면이 표시됩니다. 매칭되지 않으면 자동으로 본부 매입됩니다.

수금 방법

🏦 무통장입금

등록된 은행 계좌로 입금을 받습니다. 구매자가 계좌에 직접 이체합니다.

📡 연락처송금

카카오 QR코드 또는 연락처를 통해 송금을 받습니다. 사전에 카카오 QR이 등록되어 있어야 합니다. 미등록 시 미등록 배지가 표시되며 선택할 수 없습니다.

매칭 대기 화면

어두운 그라데이션 배경에 펄싱 애니메이션과 함께 매칭 상태가 표시됩니다.

  • 타이머: 남은 대기 시간이 MM:SS 형식으로 표시됩니다.
  • 📈
    진행 상태: 등록 건수, 매칭 건수, 총 금액, 진행률 바가 표시됩니다.
  • 🔔
    매칭 알림: 매칭 완료 시 금액, 구매자 이름, 입금 상태가 카드 형태로 나타납니다.
판매 완료: 모든 매칭이 완료되면 녹색 완료 화면이 나타나며, "거래 내역 보기" 버튼으로 상세 내역을 확인할 수 있습니다.
7
거래내역
모든 P2P 거래의 이력과 상세 정보 확인

📋 거래내역 목록

/p2p/trades
거래내역 화면

모든 P2P 구매/판매 거래 이력을 확인하는 페이지입니다. 다양한 필터로 원하는 거래를 빠르게 찾을 수 있습니다.

필터 옵션

  • 🔭
    유형 필터: 전체 판매 구매 중 선택
  • 📌
    상태 필터: 전체, 대기중, 진행중, 완료, 취소, 분쟁 중 선택 (가로 스크롤)
  • 📅
    기간 필터: 오늘, 1주, 1개월, 3개월, 직접입력 중 선택

거래 카드 정보

각 거래 카드에는 다음 정보가 표시됩니다:

  • 🔶
    거래 유형 아이콘 ( 또는 )
  • 🃏
    상품권 브랜드명 + 권면가 (예: "롯데상품권 300,000원권")
  • 🔗
    거래번호 (예: #RHX8CO)
  • 📅
    거래일시
  • 💵
    거래가 (파란색 큰 글씨)

거래 상태 배지

상태색상설명
대기중노란색매칭 대기 중
매칭됨파란색매칭 완료, 입금 대기
입금대기주황색입금 확인 대기
입금확인보라색입금이 확인됨
거래완료초록색거래 정상 완료
취소빨간색거래 취소됨
분쟁빨간색분쟁 접수됨
💡
무한 스크롤: 거래 목록은 스크롤을 내리면 자동으로 추가 데이터가 로드됩니다. 더 이상 데이터가 없으면 "모든 거래를 불러왔습니다" 메시지가 표시됩니다.

📄 거래 상세

/p2p/trades/[id]

개별 거래의 상세 정보를 확인하는 페이지입니다.

  • 📌
    상태 및 타임라인: 현재 거래 상태가 큰 배지로 표시되며, 카운트다운 타이머가 있을 수 있습니다.
  • 🃏
    거래 정보: 상품권 브랜드, 권면가, 거래 유형, 거래 금액, 상대방 정보가 표시됩니다.
  • 🏦
    이체 정보: 은행명, 계좌번호(복사 가능), 예금주, 입금 금액이 표시됩니다.
  • 🖨
    영수증: "영수증" 버튼을 눌러 거래 영수증을 확인하고 인쇄할 수 있습니다.

액션 버튼

💵 입금 완료 알리기

구매자가 입금 후 판매자에게 알립니다.

✅ 입금 확정

판매자가 입금을 확인하고 거래를 완료합니다.

❌ 거래 취소

거래를 취소합니다. 취소는 되돌릴 수 없습니다.

⚠ 분쟁 신청

문제 발생 시 사유를 선택하여 분쟁을 신청합니다.

8
내 상품권
보유 상품권 조회 및 관리

💳 내 상품권 화면

/gifts
내 상품권 화면

현재 보유 중인 모든 상품권을 확인하고, 판매 또는 선물을 위해 선택할 수 있습니다.

  • 📋
    보유 상품권 목록: "보유 상품권 N장" 헤더와 함께 상품권 카드가 나열됩니다. 각 카드에는 브랜드명, 시리얼번호, 권면가가 표시됩니다.
  • 선택 기능: 체크박스로 개별 선택하거나 "전체 선택" 버튼으로 모두 선택합니다. 선택된 카드는 파란색 테두리와 배경으로 강조됩니다.
  • 📌
    기타 상품권: 판매중, 완료, 사용완료 등 다른 상태의 상품권도 회색으로 표시됩니다 (선택 불가).

선택 후 액션

상품권을 선택하면 하단에 액션 바가 나타납니다:

🎁 선물

선택한 상품권을 다른 사용자에게 선물합니다. 보라색 버튼.

📤 판매

선택한 상품권을 본부에 판매(매각)합니다. 파란색 버튼. 수수료 차감 후 잔액으로 지급됩니다.

9
선물 보내기
상품권 선택 → 받는 사람 검색 → 메시지 작성 → 전송

🎁 선물 보내기 화면

/gifts/send
선물 보내기 화면

보유 상품권을 다른 사용자에게 선물하는 2단계 프로세스입니다.

🃏 상품권 선택
👤 받는 사람 선택
💬 메시지 작성
📤 선물 전송

Step 1: 상품권 선택

보유 상품권 중 선물할 상품권을 체크합니다. 선택 후 하단의 보라색 "다음: 받는 사람 선택" 버튼을 누릅니다.

Step 2: 받는 사람 선택

  • 자주 보내는 사람: 이전에 선물을 보낸 사람들이 상단에 빠른 선택 버튼으로 표시됩니다.
  • 🔍
    검색: 이름, 아이디, 전화번호로 사용자를 검색합니다. 결과에서 원하는 사람을 탭하여 선택합니다.
  • 💬
    선물 메시지: 선택 후 200자 이내의 메시지를 작성할 수 있습니다 (선택사항).
⚠️
주의: 보낸 선물은 취소할 수 없습니다. 전송 전 확인 모달에서 받는 사람, 금액, 수량을 반드시 확인해주세요.
10
상품권 사용 (환급)
보유 상품권의 사용 신청

🎫 상품권 사용 화면

/gifts/redeem
상품권 사용 화면

보유 상품권을 현금으로 환급받기 위한 사용 신청 페이지입니다.

  • 📋
    사용 신청 내역 확인: 상단에 "사용 신청 내역 확인 → 보기" 링크로 이전 신청 내역을 조회할 수 있습니다.
  • 상품권 선택: "전체 선택/해제" 버튼과 체크박스로 사용할 상품권을 선택합니다.
  • 💵
    신청 버튼: 하단의 파란색 "상품권 사용 신청" 버튼으로 신청을 완료합니다.

사용 신청 내역 페이지 (/gifts/redemptions)

신청한 내역을 상태별로 필터링하여 확인합니다.

상태아이콘설명
대기중🕐관리자 검토 대기
완료사용 승인 및 처리 완료
거절사용 거절됨 (사유 표시)
11
선물 내역
보낸/받은 선물 이력 관리

🎁 선물 내역 화면

/gifts/history
선물 내역 화면

선물을 보내고 받은 전체 이력을 확인하는 페이지입니다.

  • 📤
    빠른 재선물: 상단에 이전에 선물을 보낸 사람들의 버튼이 가로 스크롤로 표시됩니다. 빠르게 재선물할 수 있습니다.
  • 🔭
    필터: 전체 20 보낸 선물 9 받은 선물 11 형태로 필터링합니다. 각 필터에 건수 배지가 표시됩니다.

각 선물 카드 정보

  • 보낸 선물: 주황색 위쪽 화살표 아이콘 + 받는 사람 이름
  • 받은 선물: 초록색 아래쪽 화살표 아이콘 + 보낸 사람 이름 + 수령 배지
  • 💬
    선물 메시지: 메시지가 있으면 회색 박스에 표시됩니다.
  • 🔗
    시리얼번호 + 금액, 날짜 정보

받은 선물 액션 버튼

받은 선물에는 판매 버튼과 선물하기 버튼이 표시되어 바로 활용할 수 있습니다.

12
QR 결제
가맹점 QR코드를 스캔하여 상품권으로 결제

📡 QR 스캔 화면

/scan
QR 스캔 화면

카메라로 가맹점 QR코드를 스캔하거나 갤러리에서 QR 이미지를 선택하여 결제합니다.

  • 📷
    카메라 스캔: 카메라가 활성화되면 화면 중앙의 녹색 프레임 안에 QR코드를 위치시킵니다. 자동으로 인식됩니다.
  • 🖼
    갤러리에서 선택: 하단의 "갤러리에서 선택" 버튼을 눌러 저장된 QR코드 이미지를 업로드할 수 있습니다.
  • 📌
    안내 문구: 화면 하단에 "가맹점 QR 코드를 스캔하세요" 메시지가 표시됩니다.

결제 프로세스

📡 QR 스캔
💵 결제 정보 확인
✅ 결제 완료

QR코드 인식 후 결제 페이지(/pay)로 이동하여 가맹점 정보와 결제 금액을 확인한 뒤 결제를 진행합니다. 결제 이력은 QR내역(/pay/history)에서 확인할 수 있습니다.

13
마이페이지
프로필, 계좌, 보안, 테마 등 개인 설정 관리

👤 마이페이지 화면

/profile
마이페이지 상단
마이페이지 하단

사용자 프로필과 각종 설정을 관리하는 페이지입니다.

프로필 카드

  • 👤
    아바타: 이름 첫 글자가 그라데이션 원 안에 표시됩니다.
  • 💳
    이름 + 아이디: 사용자 이름과 로그인 아이디가 표시됩니다.
  • 🔐
    인증 배지: 휴대폰 인증, 계좌 인증 상태가 배지로 표시됩니다. (녹색: 인증완료, 회색: 미인증)

요약 정보 (2열 그리드)

💵 잔액

보유 상품권 총 금액 (예: 140,000원)

🃏 상품권 수

보유 상품권 개수 (예: 9장)

다크 모드

태양/달 아이콘과 토글 스위치로 다크 모드를 활성화/비활성화합니다. 설정은 저장됩니다.

가맹점 연결

추천 코드를 입력하여 가맹점에 소속될 수 있습니다. 연결된 가맹점은 목록으로 표시되며, 휴지통 아이콘으로 삭제할 수 있습니다.

설정 메뉴

메뉴경로설명
프로필 수정/profile/edit이름, 이메일 등 기본 정보 변경
휴대폰 변경/profile/phone연락처 번호 변경 (OTP 인증 필요)
계좌 관리/profile/bank입금 계좌 등록/변경 (1원 인증 필요)
보안 설정/profile/security비밀번호 변경
연락처송금/profile/remittance카카오 QR/프로필 관리
거래내역/p2p/trades구매/판매 내역 확인

로그아웃

하단의 빨간색 "로그아웃" 버튼으로 로그아웃합니다. 로컬 저장소가 초기화됩니다.

🏦 계좌 관리 상세

/profile/bank

P2P 거래 시 입금받을 계좌를 관리합니다.

계좌 정보 입력

은행명(드롭다운), 계좌번호, 예금주를 입력합니다.

1원 인증 요청

"1원 인증 요청" 버튼을 누르면 해당 계좌에 1원이 입금됩니다.

인증 코드 입력

입금 메모에 포함된 4자리 코드를 입력합니다.

저장

인증 완료 후 "저장" 버튼으로 계좌를 등록합니다. 녹색 인증완료 배지가 표시됩니다.

14
고객센터
1:1 채팅 문의 및 FAQ

💬 고객센터 화면

/support
고객센터 화면

관리자에게 직접 1:1 채팅으로 문의하거나, 자주 묻는 질문을 확인할 수 있습니다.

헤더 영역

  • 💬
    안내 메시지: "관리자가 직접 답변드립니다"
  • 운영시간: 09:00~18:00 배지 표시
  • 🔒
    보안: 보안 배지 표시

2개 탭

💬 채팅 문의

실시간 1:1 채팅입니다. 보낸 메시지는 오른쪽 파란 말풍선, 받은 메시지는 왼쪽 흰 말풍선에 표시됩니다. 하단 입력란에서 메시지를 작성하고 전송 버튼(파란 원)으로 보냅니다. Enter로 전송, Shift+Enter로 줄바꿈합니다.

❓ 자주 묻는 질문

FAQ 목록이 아코디언 형태로 표시됩니다. 질문을 탭하면 답변이 파란색 박스에 펼쳐집니다. 하단에 "해결이 안 되셨나요?" 안내와 함께 채팅으로 전환할 수 있는 버튼이 있습니다.

거래내역 첨부 기능

채팅 입력란 옆의 클립 아이콘(📎)을 누르면 자신의 거래 목록이 나타나며, 특정 거래를 선택하여 메시지에 첨부할 수 있습니다. 첨부된 거래는 카드 형태(거래번호, 유형, 상품권, 금액, 상태)로 메시지에 표시됩니다.

15
알림
거래, 선물, 시스템 알림 관리

🔔 알림 화면

/notifications
알림 화면

거래 상태 변경, 선물 도착, 시스템 공지 등의 알림을 확인하는 페이지입니다.

  • 🔔
    알림 목록: 시간순으로 알림이 나열됩니다. 각 알림에는 아이콘, 제목, 내용, 시간이 표시됩니다.
  • 🔴
    읽음 표시: 읽지 않은 알림은 배경색이 다르게 표시됩니다. 탭하면 읽음 처리됩니다.
  • 전체 읽음: "모두 읽음" 버튼으로 모든 알림을 한번에 읽음 처리할 수 있습니다.
  • 🗑
    전체 삭제: 모든 알림을 삭제할 수 있습니다.

알림이 없는 경우 종 아이콘과 "알림이 없습니다" 메시지가 표시됩니다.

🔔
푸시 알림: 앱 설치 시 푸시 알림을 허용하면 앱을 사용하지 않을 때에도 중요한 거래 알림을 실시간으로 받을 수 있습니다.
+
부록: 선물 도착 알림
새 선물이 도착하면 자동으로 표시되는 모달

🎁 선물 도착 모달

로그인 후 새로운 선물이 있으면 화면 중앙에 아름다운 그라데이션(분홍~주황) 모달이 자동으로 나타납니다.

  • 🎁
    "선물이 도착했어요!" 타이틀과 함께 N건의 새 선물 수가 표시됩니다.
  • 🃏
    선물 목록: 각 선물의 브랜드명, 권면가, 보낸 사람이 스크롤 가능한 목록으로 표시됩니다.
  • 💵
    잔액 반영 완료: 하단에 "잔액 반영 완료 · 총 ○○원" 메시지가 표시됩니다.
  • 📤
    액션 버튼: "판매" (파란색)와 "선물" (보라색) 버튼으로 바로 활용할 수 있습니다.
  • 닫기: X 버튼이나 "닫기" 텍스트로 모달을 닫습니다.