페리 예약 API
여행사와 OTA를 위한 페리 API: 운항편, 차량, 티켓
페리 API를 사용하면 웹사이트에서 항구 간 실제 운항편을 보여주고 같은 방문 안에서 티켓까지 판매할 수 있습니다. 이 페이지에서는 페리 API가 반환하는 정보, 페리 예약에 이름과 날짜 외에 더 많은 정보가 필요한 이유, 티켓 발급과 체크인 방식, 그리고 PHPTRAVELS가 페리 연동을 자사 도메인의 예약 엔진으로 바꾸는 방법을 설명합니다.
- 시간표와 좌석 현황
- 차량, 객실, 반려동물
- 전자 티켓과 체크인
- 섬 여행
개요
페리 API가 설명하는 것은 상품 목록이 아니라 항구 네트워크입니다
항공에는 공항 코드가, 호텔에는 주소가 있습니다. 페리에는 항구, 항구를 잇는 항로, 그리고 요일별로 각 항로를 운항하는 선사가 있습니다. 페리 API는 먼저 그 네트워크를 제공하고, 그다음 그 위의 운항편을 제공합니다.
항로 예시
- 피레우스본토 항구구간 1 · 여러 선사
- 낙소스섬 거점구간 2 · 시즌 운항
- 산토리니섬
01항구
여행자가 출발지와 도착지로 검색하는 기항지로, 항구 이름과 국가가 포함됩니다. 한 도시에 터미널이 여러 곳일 수 있어 API는 정확한 항구를 반환합니다.
02항로
두 항구를 잇는 노선입니다. 검색 폼에는 연결된 선사가 실제로 운항하는 구간만 표시되므로 존재하지 않는 항로를 검색할 일이 없습니다.
03운항편
각 항로의 날짜별 출항편으로, 선박, 시간, 선내 남은 자리가 포함됩니다. 분 단위로 바뀌는 부분입니다.
내부적으로 페리 모듈은 네트워크를 한곳에서 관리합니다. 연결된 선사의 항로와 직접 등록한 항로가 나란히 놓이고, 항구를 공유하는 항로는 이어져 더 긴 여정이 됩니다. 작동 방식은 페리 페이지를 참고하세요.
시간표와 좌석 현황
두 번의 호출로 출발 안내판이 채워집니다
페리 검색에는 두 가지 질문이 있습니다. 이 항로와 날짜에 어떤 운항편이 있는지, 그리고 이 승객과 차량이 탈 자리가 아직 있는지입니다. 공급사는 이를 따로 응답하므로 가격을 보여주기 전에 둘 다 필요합니다.
| 출발 | 행선지 | 선박 | 소요 시간 | 좌석 현황 |
|---|---|---|---|---|
| 07:00 | 낙소스 | 고속 페리 | 3시간 35분 | 판매 중좌석만 가능, 차량 불가 |
| 07:25 | 낙소스 | 로팩스 페리 | 5시간 40분 | 판매 중좌석과 차량 공간 |
| 07:30 | 미코노스 | 로팩스 페리 | 5시간 15분 | 잔여 소수좌석과 차량 공간 |
| 13:00 | 파로스 | 카타마란 | 3시간 10분 | 판매 중좌석만 가능, 차량 불가 |
| 17:30 | 산토리니 | 로팩스 페리 | 7시간 50분 | 잔여 소수객실 잔여 소수 |
| 21:00 | 이라클리온 | 크루즈 페리 | 9시간 00분 | 매진다음 운항편 안내 |
예시 데이터, 단순화됨
- 시간표
어떤 운항편이 있는가
항로, 날짜, 시간대를 입력하면 출발·도착, 선박, 운항 시간이 반환됩니다. 시간표는 시즌에 따라 바뀌므로 실시간으로 조회하거나 자주 갱신하며, 수작업으로 입력하지 않습니다.
- 좌석 현황
선내에 자리가 있는가
데크석, 좌석, 객실, 차량 레인은 각각 별도의 정원입니다. 좌석은 남아 있어도 차량 공간이 없는 운항편이 있을 수 있으므로, 정확한 인원과 차량으로 확인합니다.
- 요금
이 일행이 내는 금액
운임은 승객 유형, 선내 등급, 차량 크기에 따라 달라집니다. 마지막 객실이 이미 나갔을 수 있으므로 결제 직전에 다시 요금을 계산합니다.
페리가 다른 점
페리 예약에는 사람, 차량, 잠잘 곳이 함께 담깁니다
항공사에 필요한 것은 이름과 날짜입니다. 페리 선사는 연령대별 승객, 차량 데크에 싣는 것, 모두가 앉거나 자는 위치, 동물 동반 여부까지 알아야 합니다. 모든 답변이 요금과 남은 공간을 좌우합니다.
01승객 유형
- 성인2
- 소아1
- 유아0
- 경로0
선사는 성인, 소아, 유아, 경로 요금을 다르게 책정하고 연령 기준도 각자 정합니다. 일부 항로에는 주민 또는 학생 요금도 있습니다. API는 해당 항로가 받는 유형을 알려줍니다.
02차량
- 길이
- 5 m 이하
- 높이
- 2 m 미만
차량 공간은 종류와 크기별로 판매됩니다. 길이는 차지하는 레인을 정하고, 캠핑카나 밴처럼 높은 차량은 다른 데크가 필요할 수 있어 높이도 중요합니다. 치수가 틀리면 항구에서 추가 요금이 붙을 수 있습니다.
03선내
- 데크자유석
- 지정석번호 있음
- 객실침대 수, 객실 단위
데크석, 지정석, 객실은 각각 정원이 다른 별도 등급입니다. 좌석은 승객별, 객실은 보통 객실별로 요금을 매기며, 야간 운항에서 특히 중요합니다.
04반려동물
강아지 1마리, 케이지 동반
규정은 선사와 선박마다 달라 케이지, 반려동물 동반 객실, 또는 불가한 경우도 있습니다. 반려동물은 요금과 정원이 따로 있는 추가 항목이라 티켓과 함께 예약합니다.
예시 양식, 단순화됨
예약 이후
발권과 체크인
페리 판매는 결제로 끝나지 않습니다. 여행자는 승선해야 하고, 일정은 바뀌며, 바다의 사정도 영향을 줍니다. 페리 API와 플랫폼이 함께 처리하는 부분입니다.
전자 티켓
많은 선사가 휴대폰이나 종이로 제시할 수 있는 스캔용 코드가 담긴 전자 티켓을 발급합니다. 플랫폼은 청구서와 함께 이메일로 보내고 고객 계정에도 보관합니다.
항구에서의 승선
일부 항로는 여전히 선사의 항구 사무소에서 예약 번호를 승선권으로 교환해야 합니다. 어느 방식인지, 어디로 가야 하는지는 예약 확인서에 안내됩니다.
체크인 마감
차량은 보통 도보 승객보다 일찍 체크인해야 하고, 국제 항로에는 여권이 필요합니다. 온라인 판매는 항로의 체크인 마감 시각에 종료됩니다.
변경
날짜, 시간, 승객, 차량 변경은 운임 조건을 따르며 수수료나 운임 차액이 발생할 수 있습니다. 변경 후에는 티켓이 재발행됩니다.
기상 악화로 인한 결항
선사는 날씨와 해상 상태에 따라 운항편을 취소하거나 지연시킵니다. 영향받은 여행자에게 알리고 다음 운항편으로 옮기거나 선사 약관에 따라 환불하는 방법을 미리 정해 두세요.
취소와 환불
운임마다 환불 규정이 다릅니다. 고객이 무엇을 구매했는지 알 수 있도록 결제 전에 보여주고, 환불은 원래 결제 수단으로 처리합니다.
선사는 각자 조건을 공개하며 플랫폼은 운항편마다 이를 표시합니다. 선사와 여행사를 위한 처리 방식은 페리 예약 소프트웨어와 비교해 보세요.
PHPTRAVELS에 준비됨
내 계정으로 켜는 페리 커넥터
아래 페리 공급사는 이미 PHPTRAVELS 페리 모듈에 연결되어 있습니다. 공급사와 계약하고 관리자 화면에 인증 정보를 입력하면 해당 운항편이 검색에 나타납니다. 목록은 연동 디렉터리에서 실시간으로 가져옵니다.
안내판을 채우는 다른 방법
- 얼롯먼트: 선사가 배정해 주는 좌석, 객실, 차량 공간으로, 소진되면 판매가 중단됩니다.
- 자체 항로: 직접 운항하거나 계약한 항로로, 자체 시간표와 운임을 사용합니다.
- 다른 페리 선사의 API: 문서화된 API라면 추가할 수 있으며 소스 코드는 고객님의 것입니다. 맞춤형 API 연동을 참고하세요.
섬 여행
여러 구간, 하나의 여정, 한 번의 결제
섬 여행이 한 번의 운항으로 끝나는 경우는 드뭅니다. 비행기로 도착해 항구로 이동하고, 한 섬으로 건너간 뒤 다음 섬으로 이어집니다. 이 구간들을 묶을 수 있다는 점이 완전한 예약 플랫폼 안에 페리 API가 있어야 하는 이유입니다.
- 연결 확인각 구간은 이전 구간이 도착한 뒤 설정한 최소 간격을 두고 시작할 수 있어, 불가능한 연결이 포함된 여정은 만들어지지 않습니다.
- 한 번의 결제구간마다 선사와 공급원이 달라도 고객은 한 번만 결제하고 구간별로 티켓을 받습니다.
- 정보 자동 이어짐승객과 차량 정보가 구간 간에 그대로 이어지므로 같은 내용을 두 번 입력할 필요가 없습니다.
항공권 API 연동으로 항공 구간을, 공항 픽업 기술로 항구까지의 이동을 추가하세요. 모두 하나의 플랫폼에서 다른 여행 API와 함께 작동합니다.
- 아테네행 항공연결한 항공권 공급사의 항공 구간입니다.
- 공항에서 피레우스까지공항에서 페리 터미널까지의 이동 서비스입니다.
- 피레우스 → 낙소스첫 번째 운항, 차량과 성인 2명 탑승.
- 낙소스 3박두 운항 사이의 호텔 숙박입니다.
- 낙소스 → 산토리니두 번째 운항, 다른 선사일 수도 있습니다.
페리 API는 페리 선사나 페리 예약 플랫폼이 제공하는 웹 서비스 모음으로, 여행 웹사이트가 항구, 항로, 시간표를 조회하고 승객과 차량의 좌석 현황을 확인하며 예약을 생성하고 티켓을 실시간으로 받을 수 있게 해 줍니다.
페리 예약에는 종류와 크기별로 요금이 정해지는 차량, 데크석·좌석·객실 같은 선내 등급, 반려동물이 추가됩니다. 좌석 현황은 각각 따로 집계되고 체크인 마감도 도보 승객과 차량이 다릅니다.
네, 해당 운항편에서 선사가 차량을 실을 때 가능합니다. 예약 시 차량 종류와 치수를 전송하며, 운임에는 차량 데크 공간이 포함됩니다.
네, 선박에 객실이 있는 경우 가능합니다. 객실은 정원이 별도인 독립된 등급이며 보통 승객별이 아닌 객실별로 요금을 매깁니다.
이 페이지에 표시되는 페리 공급사는 실시간 연동 디렉터리에서 가져옵니다. PHPTRAVELS는 Kikoto Ferries의 공식 기술 파트너이며, 다른 선사는 맞춤 연동으로 추가할 수 있습니다.
아니요. 각 페리 공급사와 직접 계약하고 관리자 화면에 본인의 인증 정보를 입력합니다. PHPTRAVELS는 예약 플랫폼과 기본 제공 커넥터를 제공합니다.
네. 고객이 구간을 차례로 추가하면 각 구간이 이전 도착 시각과 대조되고, 전체 여정을 한 번의 결제로 지불하며 구간별 티켓을 받습니다.
네. 직접 운항하거나 계약한 항로, 선사 얼롯먼트, API 운항편이 같은 검색에 표시되며 각각 고유한 운임과 마크업이 적용됩니다.
네. B2B 에이전트는 에이전트 포털에서 자체 마크업이나 수수료로 예약하고 지갑 잔액으로 결제합니다. 공개 웹사이트와 같은 설치 환경에서 작동합니다.