투어·액티비티 API
여행사를 위한 Viator API 연동
Viator Partner API를 통해 Viator의 투어, 명소, 액티비티를 PHPTRAVELS 예약 사이트에 추가하세요. Viator는 상품, 요금, 일정, 리뷰를 제공하고 PHPTRAVELS는 검색, 마크업, 통화, 예약 기록을 담당합니다.
- 투어 카테고리의 Viator 모듈
- 샌드박스·운영 엔드포인트
- 모든 Viator 요금에 마크업
- 일정, 포함 사항, 리뷰
작동 방식
자체 여행 웹사이트에서 판매하는 Viator 체험
Viator API 연동은 예약 웹사이트를 Viator 파트너 계정과 연결해 투어와 액티비티를 항공권, 호텔 옆에 보여 줍니다. PHPTRAVELS는 투어 카테고리에 Viator 모듈을 제공합니다. 관리자 화면에 Viator API 키를 붙여 넣고 샌드박스 또는 운영 환경을 선택하면, 목적지 검색에서 마크업이 적용된 Viator 상품이 반환됩니다. 파트너 권한과 예약 모델은 Viator가 부여하므로 출시 계획 전에 계정 유형을 확인하세요.
- Viator 파트너 프로그램에 신청하고 API 키를 받습니다
- PHPTRAVELS 관리자에서 Modules를 열고 Viator 설정에 키를 입력합니다
- 샌드박스 환경을 선택하고 저장해 자격 증명 확인을 실행합니다
- 마크업을 설정하고 주요 목적지 검색을 테스트합니다
- 결과와 요금이 정확하면 운영 환경으로 전환합니다
- 환경
- 샌드박스
- 엔드포인트
- Partner API v2 · api.sandbox.viator.com
- API 키
- ••••••••-••••-••••
- 마크업
- Viator 요금에 10%
- 표시 통화
- 고객 세션 통화
검색과 상세 정보
투어 검색 결과 속 Viator 상품, 고객이 확인하는 정보와 함께
각 Viator 결과에는 제목, 최저 요금, 소요 시간, 평점, 이미지가 담기고, 상세 페이지에는 포함·불포함 사항, 일정 경유지, 취소 정책이 추가됩니다.
- 4.7★저녁 식사 포함 이브닝 사막 사파리6시간 · 평점 4.7 · 무료 취소US$72성인 1인
- 4.5★두바이 마리나 다우 디너 크루즈2시간 · 포함·불포함 사항 안내US$58성인 1인
- 두바이 출발 아부다비 일일 투어10시간 · 지도 경유지가 있는 일정US$115성인 1인
목적지 검색
목적지와 날짜를 Viator 자유 텍스트 상품 검색으로 보내며, 요금·평점 필터와 페이지당 최대 100개 상품을 지원합니다.
위치 확인
결과를 상품 주소와 제목의 목적지와 대조해 관련 없는 투어를 목록에서 제외합니다.
전체 상품 정보
상세 페이지는 Viator 상품의 설명, 포함·불포함 사항, 일정 항목을 불러오며, Viator가 제공하면 지도 위치도 표시합니다.
평점과 리뷰
각 투어에 Viator 평균 평점과 총 리뷰 수가 표시되어 고객이 체험을 비교할 수 있습니다.
취소 정책
Viator 취소 정책 문구가 투어에 표시되며, 상품의 정책 유형에서 가져온 환불 가능 여부가 함께 나옵니다.
마크업과 통화
Viator 최저 요금에 마크업을 더해 고객 통화로 환산하고, 공급사 요금도 함께 저장합니다.
예약 흐름
Viator 검색에서 저장된 예약까지
표준 모듈에서 Viator 상품 하나가 사이트를 거치는 경로입니다.
검색
목적지, 날짜, 여행자 정보가 Viator로 전송되고 일치하는 상품이 돌아옵니다.
요금
각 최저 요금에 마크업과 통화 환산이 적용됩니다.
상세
고객이 상품을 열어 일정, 포함 사항, 취소 정책을 확인합니다.
기록
여행자, 공급사 요금, 판매 요금과 함께 예약 기록이 관리자에 저장됩니다.
Viator에서 완료
고객은 새 창에서 Viator 상품 페이지로 이동해 예약을 마칩니다.
역할 분담
Viator API 연동에서 누가 무엇을 하나
제대로 작동하는 Viator 연결에는 예약 플랫폼, 승인된 Viator 파트너 계정, 그리고 결제를 누가 받는지에 대한 명확한 합의가 필요합니다.
PHPTRAVELS: 예약 플랫폼
웹사이트, Viator 모듈 설정, 마크업, 통화, 투어 페이지, 예약 기록. 그 밖의 B2C·B2B 도구는 패키지에 따라 다릅니다.
Viator: 체험 콘텐츠
Partner API를 통한 상품, 요금, 일정, 리뷰, 취소 정책. 접근 수준과 예약 조건은 Viator가 정합니다.
여행사: 영업 프로세스
판매 요금, 고객 소통과 지원, 그리고 Viator와의 변경·취소를 누가 처리할지까지 포함합니다.
백오피스
관리자에서 Viator 판매 운영
Viator 상품의 자격 증명, 요금, 예약 기록을 자체 투어 및 다른 공급사와 같은 대시보드에서 관리합니다.
모듈 설정
API 키와 환경이 Modules에 저장되며, 자격 증명 확인이 오픈 전에 임시 키를 거부합니다.
공급사 요금과 판매 요금
각 예약 기록에 성인·아동의 Viator 요금과 마크업 적용 요금이 나란히 저장되어 예약별 마진이 보입니다.
통화
Viator 요금은 상품 통화에서 고객 세션 통화로 환산되며 두 통화 모두 저장됩니다.
자체 투어와 함께
Viator 상품은 투어 모듈에서 만든 자체 투어와 하나의 검색, 하나의 관리자에서 함께 운영됩니다.
Viator Merchant 모듈
별도 모듈이 해당 모델의 계정을 위해 Viator Merchant API 키와 Merchant ID를 저장하고 확인합니다.
자사 사이트 결제
자체 결제 화면에서 결제를 받고 Viator 예약을 확정하는 기능은 프로젝트별 커스터마이징으로 산정합니다.
비교
Viator API로 직접 개발 vs PHPTRAVELS
Viator는 상품 API를 제공할 뿐, 그 주변의 예약 사이트는 따로 필요합니다. PHPTRAVELS와 비교해 직접 개발에 일반적으로 필요한 작업입니다.
| 항목 | Viator API 기반 직접 개발 | PHPTRAVELS |
|---|---|---|
| 투어 웹사이트 | Viator API 기반 직접 개발검색, 결과, 상품 페이지를 처음부터 설계하고 개발 | PHPTRAVELS브랜드가 적용된 투어 검색, 결과, 상세 페이지가 이미 준비됨 |
| Viator 연결 | Viator API 기반 직접 개발검색, 상품 상세, 요금 호출을 직접 작성하고 테스트 | PHPTRAVELS샌드박스, 자격 증명 확인, 마크업을 갖춘 기존 Viator 모듈 |
| 상품 콘텐츠 | Viator API 기반 직접 개발일정, 포함 사항, 리뷰 매핑을 새로 구축해야 함 | PHPTRAVELS포함·불포함 사항, 일정, 리뷰, 정책 매핑 완료 |
| 관리와 마진 | Viator API 기반 직접 개발예약 기록과 요금 규칙을 새로 구축해야 함 | PHPTRAVELS모든 예약에 공급사 요금과 판매 요금 저장 |
| 기타 상품 | Viator API 기반 직접 개발항공, 호텔, 자체 투어는 별도 프로젝트 | PHPTRAVELS항공, 호텔, 렌터카, 자체 투어 모듈이 같은 설치본에 |
활용 사례
Viator를 PHPTRAVELS에 연결하는 곳
온라인 여행사
항공권과 호텔 옆에 현지 액티비티를 더해 여행자가 한 사이트에서 전체 여행을 계획하게 하세요.
지상 수배 업체(DMC)
모든 투어를 직접 운영하지 않는 목적지에서 자체 관광 상품과 Viator 상품을 결합하세요.
여행 콘텐츠 퍼블리셔
목적지 가이드를 예약 사이트로 바꾸고, 다루는 도시마다 Viator 체험을 소개하세요.
PHPTRAVELS를 선택하는 이유
Viator 계정도, 플랫폼도, 코드도 여러분의 것
소스 코드 포함
상용 라이선스로 자체 호스팅하므로 개발자가 Viator 흐름을 확장할 수 있습니다.
여러분의 Viator 자격 증명
API 키는 여러분이 보유하며, 자체 설치본에 저장되고 저장 시 확인됩니다.
샌드박스 먼저
모듈을 운영 환경으로 전환하기 전에 Viator 샌드박스 엔드포인트에서 테스트하세요.
B2C와 B2B
공개 웹사이트와 에이전트 포털을 하나의 설치본으로, 24개 언어로 운영합니다.
투어 카테고리의 Viator 모듈을 통해 Viator Partner API를 PHPTRAVELS 예약 플랫폼에 연결하는 것입니다. Viator는 요금, 일정, 리뷰가 포함된 투어와 액티비티를 제공하고, PHPTRAVELS는 웹사이트, 마크업, 통화, 예약 기록을 제공합니다.
Viator는 파트너 프로그램을 통해 API 접근 권한을 부여합니다. 승인 후 받은 API 키를 Viator 모듈 설정에 입력합니다. 자격 요건, 접근 수준, 상업 조건은 Viator에 직접 확인하세요.
네. 모듈은 Viator 샌드박스 엔드포인트나 운영 환경을 가리킬 수 있으며, 자격 증명 확인은 선택한 환경에서 실행됩니다. 검색과 요금을 테스트한 뒤에 운영 환경으로 전환하세요.
표준 모듈에서는 PHPTRAVELS가 여행자와 요금이 담긴 예약 기록을 저장한 뒤 Viator 상품 페이지를 열어 고객이 그곳에서 예약을 마칩니다. 자체 결제 화면에서의 결제와 확정은 커스터마이징으로 산정합니다.
네. PHPTRAVELS 투어 모듈에서 만든 투어와 Viator 상품은 같은 검색과 관리자를 공유하며, Tiqets도 또 다른 투어 공급사로 이용할 수 있습니다.
Viator 전용 가이드는 아직 docs.phptravels.com에 게시되지 않았습니다. 설정은 모듈 설정에서 API 키와 환경을 지정하는 것이며, 도입 과정에서 PHPTRAVELS 팀이 도와드릴 수 있습니다.