// HOW THIS WORKS
저장 목적지 기반 귀가 UX
01
카드 ID 인식QR 또는 NFC 스캔으로 카드 고유 식별자를 서버에 전달합니다.
02
기본 목적지 조회호텔 체크인 연동 또는 사용자 1회 설정을 통해 저장된 “내 숙소”를 불러옵니다.
03
요금 계산 후 외부 연결공개 API로 예상 거리·시간·요금을 보여주고, 마지막 배차는 택시앱 또는 콜택시로 넘깁니다.
// SYSTEM DESIGN
MVP 구성 요소
카드 자체가 호텔을 인식하는 것이 아니라, 카드 ID를 키로 사용해 서버가 저장된 목적지를 반환하는 구조입니다. 즉 “카드는 열쇠, 목적지는 서버 메모리”라는 개념입니다.
card_id
user profile
default_destination
hotel_link
fare estimate API
partner handoff
// BENEFITS
왜 이 구조가 유효한가
🏨
호텔 귀가 원터치
공항과 관광지에서 사용자가 매번 숙소명을 입력하지 않아도 됩니다.
👵
노인 사용자 확장
같은 구조로 “우리집 / 병원 / 시장” 즐겨찾기 목적지를 제공할 수 있습니다.
🌍
다국어 관광 UX
외국인에게는 숙소, 공항, 주요 관광지 중심의 직관적인 이동 인터페이스가 됩니다.
📊
이동 데이터 축적
어디서 어디로 이동했는지 패턴을 수집해 관광 분석과 제휴 전략에 활용할 수 있습니다.
// TOSS PAYMENTS
실제 결제 연동 준비 영역
이 영역은 Toss Payments v2 표준 SDK를 붙여 실제 결제창을 여는 용도입니다. 지금 파일은 테스트/데모 겸용이며, 클라이언트 키와 성공·실패 URL, 서버 승인 API만 연결하면 실결제로 확장할 수 있습니다.
💳
결제 실행 설정
카드는 QR 트리거이고, 결제는 웹앱에서 진행됩니다. 아래 값은 데모용 기본값이며 실운영 시 서버에서 내려주는 값을 사용하세요.
🔗
실운영 연결 방식
성공 URL로 paymentKey, amount, orderId를 받은 뒤 서버에서 secret key로 승인 API를 호출해야 최종 결제가 완료됩니다. secret key는 브라우저에 두면 안 됩니다.
01
QR로 세션 시작card_id, pickup, destination, amount를 서버 세션에 저장
02
토스 결제 요청payment.requestPayment() 또는 widgets.requestPayment() 호출
03
서버 승인 및 배차successUrl 수신값 검증 후 승인 API 호출 → 성공 시 택시 호출
데모 파일만으로는 실승인이 완료되지 않습니다. 실결제에는 Toss 상점 가입, 클라이언트 키/시크릿 키, successUrl/failUrl, 서버 승인 엔드포인트가 필요합니다.
PAYMENT STATUS
선택 목적지L7 Myeongdong Hotel
선택 금액₩68,000
상태Ready for Toss Payments