투어·액티비티 API
투어, 액티비티, 입장권을 위한 투어 API
투어 API를 사용하면 액티비티 공급사의 가이드 투어, 당일 투어, 체험, 입장권을 내 웹사이트에서 판매할 수 있습니다. 이 페이지에서는 API로 받는 콘텐츠가 어떤 모습인지 살펴봅니다. 시간대와 정원, 여행자 유형별 요금, 예약 시 공급사가 묻는 질문, 그리고 당일 여행자가 제시하는 바우처입니다.
- 날짜, 시간대, 정원
- 성인, 아동, 유아, 시니어 요금
- 바우처와 모바일 티켓
- API 재고와 함께 자체 투어도
판매 상품
투어 API로 판매하는 상품
액티비티 공급사는 성격이 매우 다른 상품을 하나의 API로 묶어 제공합니다. 예약 방식은 같아서 날짜, 대개는 시간, 연령대별 인원을 지정하지만, 상품 유형마다 사이트에서 보여줘야 할 정보는 다릅니다.
가이드 투어
가이드와 함께하는 시내 도보 투어, 박물관 투어, 음식 투어. 집합 장소, 시작 시간, 가이드 언어를 안내합니다.
당일 투어
도시에서 출발하는 종일 투어로, 호텔 픽업, 교통, 점심 포함 여부를 명시합니다.
명소 입장권
박물관, 랜드마크, 테마파크, 동물원. 날짜 자유 또는 시간 지정 입장이며 줄 서지 않고 입장하는 옵션이 있기도 합니다.
체험
요리 클래스, 크루즈, 공연, 야외 활동 등. 소요 시간과 그룹 규모는 상품마다 다릅니다.
다일정 투어
며칠에 걸친 투어로, 일자별 일정, 숙박, 고정 출발일이 포함됩니다.
송영 포함 투어
호텔이나 항구에서 왕복 송영이 포함된 액티비티로, 픽업 정보가 예약의 일부가 됩니다.

대부분의 여행사는 이런 상품을 항공권, 호텔과 한 사이트에서 함께 판매합니다. 여행 API가 어떻게 맞물리는지 확인해 보세요.
시작 시간
- 09:30매진
- 14:00매진
- 14:00매진
예시 데이터
예약 가능 여부
날짜, 시간대, 그리고 남은 좌석
여행자가 결제하기 전에 API는 예약 가능한 날짜, 그날의 시작 시간, 각 시간대에 남은 인원을 사이트에 알려 줍니다.
- 실시간 재고
- 공급사가 시간대별 정원을 관리하고 API가 남은 수량을 돌려줍니다. 다른 판매처가 마지막 자리를 가져갔을 수 있으므로 사이트는 결제 직전에 한 번 더 확인합니다.
- 프리세일
- 고정 할당 없는 상품도 있습니다. 공급사는 날짜나 시간대를 마감할 때까지 파트너가 자유롭게 판매하도록 하고, 모든 예약을 확정해 줍니다.
- 요청 예약
- 일부 상품은 공급사가 예약을 일일이 수동으로 승인합니다. 확정 또는 거절될 때까지 예약은 대기 상태이므로 결제 전에 여행자에게 알려야 합니다.
- 판매 마감 시간
- 판매는 보통 시작 몇 시간 전에 마감됩니다. 오전에 열려 있던 시간대가 오후에는 사라질 수 있습니다.
요금
예약당 한 가격이 아니라 여행자 유형별 가격
액티비티 요금은 연령대로 정해집니다. 연령대는 공급사가 상품별로 정하며, 합계는 예약에 포함된 모든 여행자의 합입니다.
| 여행자 유형 | 연령대 | 1인 요금 | 인원 | 소계 |
|---|---|---|---|---|
| 성인 | 18~64세 | – | 2 | – |
| 아동 | 4~17세 | – | 1 | – |
| 유아 | 0~3세 | 무료 | 1 | – |
| 시니어 | 65세 이상 | – | 0 | – |
| 여행자 4명 합계공급사 가격 위에 내 마크업이 더해집니다 | – | |||
- 01
연령대는 상품마다 다릅니다
아동이 어떤 투어에서는 3~12세이고 다른 투어에서는 4~17세일 수 있습니다. 모든 상품에 같은 규칙을 쓰지 말고 상품마다 연령대를 읽어 와야 합니다.
- 02
최소·최대 인원
한 번의 예약에 담을 수 있는 인원은 상품이 정하며, 아동이나 유아가 함께하면 성인 1명 이상이 필요한 상품도 있습니다.
- 03
1인당 또는 단위당
프라이빗 투어, 보트, 차량은 여행자별이 아니라 정원까지의 그룹 단위나 차량 단위로 가격이 정해지는 경우가 많습니다.
- 04
무료라고 인원에서 빠지지 않습니다
무료 유아도 인원수에 포함되므로 예약과 함께 전송되고 바우처에도 표시됩니다.
예약 질문
공급사가 예약을 받기 전에 필요로 하는 답변
많은 액티비티는 이름과 이메일만으로는 진행할 수 없습니다. 상품마다 필수 질문이 있을 수 있고, 답이 없으면 예약이 거절됩니다.
- 예약별한 번만 묻는 항목입니다. 픽업 호텔, 도착 항공편, 당일 연락 가능한 휴대폰 번호 등이 있습니다.
- 여행자별인원마다 묻는 항목입니다. 성명, 나이, 일부 액티비티에서는 키, 몸무게, 여권번호가 해당됩니다.
- 정해진 답 중 선택가이드 언어나 픽업 위치는 공급사가 제공하는 목록으로 오기 때문에 여행자는 입력하지 않고 선택합니다.
좋은 예약 흐름은 이런 질문을 결제 단계에서 여행자의 언어로 묻고, 답변을 예약과 함께 공급사에 전달합니다. 그러면 가이드가 당일 전에 내용을 받아 볼 수 있습니다.
- 픽업 장소필수
- 시내 중심가 호텔 로비
- 투어 언어필수
- 스페인어
- 식이 요구 사항선택
- 채식 1명, 견과류 불가
- 대표 여행자 전화번호필수
- +00 000 000 000
당일
여행자가 실제로 손에 쥐는 상품은 바우처입니다
공급사가 확정하면 API는 입구나 집합 장소에서 제시할 정보, 즉 코드, 공급사 예약번호, 실용적인 안내를 돌려줍니다.
예약 바우처
현지 가이드와 함께하는 구시가지 도보 투어
- 날짜
- 2026년 11월 14일 (토)
- 시작
- 09:30
- 여행자
- 성인 2명, 아동 1명, 유아 1명
- 집합 장소
- 중앙 광장, 시계탑 옆
- 공급사 예약번호
- TR-48210-KQ
- 확정
- 확정
- 모바일 또는 인쇄
휴대폰 코드로 입장되는 상품이 많지만 인쇄한 바우처를 요구하는 상품도 있습니다. 어느 쪽인지는 상품에 나와 있으니 예약 확인 메일에도 반복해서 안내하세요.
- 즉시 확정
API 상품 대부분은 몇 초 만에 확정되고 바우처도 바로 발급되어 예약 확인 메일과 함께 발송할 수 있습니다.
- 요청 후 확정
요청형 상품은 공급사가 승인한 뒤에야 바우처를 보내므로, 결제 후에도 예약 상태를 추적해야 합니다.
- 취소 규정
환불 규정은 상품마다 다르며, 시작 몇 시간 전까지 무료 취소가 가능한 경우가 많습니다. 결제 전과 바우처에 표시하세요.
PHPTRAVELS에서 바로 사용
내 계정으로 켜서 쓰는 투어 API 커넥터
아래 액티비티 공급사는 이미 PHPTRAVELS 투어 모듈에 연결되어 있습니다. 공급사와 계약하고 관리자 화면에 인증 정보를 입력한 뒤, 오픈 전에 테스트하면 됩니다. 목록은 연동 디렉터리의 실시간 정보입니다.
Tiqets바로 쓸 수 있는 커넥터연동 가이드 읽기
Tours BMS바로 쓸 수 있는 커넥터
Viator바로 쓸 수 있는 커넥터연동 가이드 읽기- 모든 연동
각 커넥터가 어디까지 지원하는지(검색과 상세 정보부터 주문, 전자 티켓까지)는 공급사와 부여받는 계정 유형에 따라 다르므로, 각 가이드에서 해당 흐름을 설명합니다. 목록에 없는 공급사는 맞춤형 API 연동을 참고하세요.
여행사를 위한 추천 글: Viator 제휴 프로그램으로 수익 내기 및 초기 투자 없이 온라인으로 투어 판매하기.
자체 상품
API 재고와 함께 자체 투어도
투어 API는 다른 회사의 콘텐츠로 사이트를 채워 줍니다. 직접 운영하는 투어와 협력하는 현지 운영사의 투어도 같은 검색에 들어가야 합니다.
PHPTRAVELS 투어·액티비티에서 일정, 출발일 또는 시간대, 좌석, 여행자 유형별 요금을 입력해 투어를 만들 수 있습니다. 공급사 액티비티와 같은 검색 결과에 노출되고, 자체 마크업 규칙을 적용할 수 있으며, 여행자는 같은 결제 화면에서 예약합니다.
직접 출발을 운영하는 운영사는 투어 운영사 소프트웨어로 가이드, 승객 명단, 예약금을 관리하고, 그 뒤의 예약, 결제, 리포트는 투어 운영사 백오피스가 맡습니다.
- 직접 운영하는 투어내 투어내 출발일, 좌석, 요금을 관리자 화면에서 관리합니다. 마진은 전부 내 몫입니다.
- 파트너 운영사현지 운영사현지 운영사가 직접 로그인해 자기 투어, 예약 가능 여부, 요금을 관리하고, 내가 마크업을 더합니다.
- 액티비티 공급사공급사 API연결된 공급사의 투어와 티켓을 실시간 재고와 내 마크업으로 제공합니다.
에이전트는 B2B 포털에서 이 세 가지를 모두 자신의 요율로 예약하고 지갑 잔액으로 결제합니다.
투어 API는 액티비티 공급사가 제공하는 웹 서비스 모음으로, 여행 웹사이트가 투어, 액티비티, 입장권을 검색하고, 날짜와 시간대를 확인하고, 여행자 유형별 요금을 받고, 예약을 생성하고, 바우처를 받을 수 있게 해 줍니다.
같은 것을 가리키는 용어입니다. 공급사에 따라 투어, 액티비티, 체험, 즐길 거리 API 등으로 부르며, 대부분 가이드 투어, 당일 투어, 체험, 입장권을 하나의 카탈로그에서 다룹니다.
네. Tiqets 같은 입장권 공급사는 성인, 아동 등 티켓 유형별로 시간 지정 및 날짜 자유 티켓을 제공하며, 주문 후 전자 티켓을 돌려줍니다.
네. 공급사마다 신청해서 자신의 API 키를 받습니다. 계정에서 어떤 상품, 가격, 예약 권한을 쓸 수 있는지는 공급사가 결정합니다. PHPTRAVELS는 공급사 인증 정보를 제공하지 않습니다.
실시간 재고에서는 공급사가 날짜나 시간대별 정원을 관리하고 API가 남은 자리를 돌려줍니다. 프리세일에서는 공급사가 고정 할당 없이 파트너가 판매하도록 하고, 날짜를 마감할 때까지 모든 예약을 확정해 줍니다.
보통 여행자 유형별이며, 성인, 아동, 유아, 시니어 같은 연령대는 공급사가 상품마다 정합니다. 프라이빗 투어와 차량은 그룹 단위나 차량 단위로 가격이 정해지는 경우가 많습니다. 여기에 내 마크업이 더해집니다.
투어 모듈에는 Viator, Tiqets, Tours BMS 같은 액티비티 공급사용 커넥터가 준비되어 있습니다. 최신 목록은 연동 디렉터리에 있으며, API 문서가 있는 공급사라면 맞춤 연동으로 추가할 수 있습니다.
네. PHPTRAVELS 투어 모듈에서 자체 출발일과 요금으로 만든 투어는 공급사 액티비티와 같은 검색에 나타나며, 각각 별도의 마크업을 적용할 수 있습니다.
네, Enterprise 플랜에서 가능합니다. 문서가 제공되는 PHPTRAVELS REST API와 웹훅으로 연결된 공급사의 검색과 예약을 하나의 형식으로 제공할 수 있습니다.
