여행 API
항공, 호텔, 렌터카, 결제를 위한 여행 API 연동
GDS, 베드뱅크, 렌터카, 투어, 결제 API를 하나의 PHP 레이어로 여행 포털에 연결하세요. 모든 공급사가 같은 검색, 요금 확인, 예약, 환불 흐름을 따르고 로그와 재시도도 공유합니다.
- XML·JSON 공급사
- 검색, 요금, 예약, 환불
- 결제와 웹훅
- 하나의 여행 API 허브
API 연동 서비스
PHP 여행 API 연동, 샌드박스부터 운영까지
여행 API는 호텔, 항공, 렌터카, 액티비티, 패키지의 검색, 요금 산정, 예약, 예약 후 처리를 제공하며 보통 키, OAuth 또는 공급사 토큰을 쓰는 XML이나 JSON 형식입니다. PHPTRAVELS는 각 공급사를 포털 안의 동일한 정규화 흐름에 연결하고 마크업, 결제, 에이전트 규칙, 요청 로그를 함께 갖추므로, 새 API는 별도 프로젝트가 아니라 설정된 공급원이 됩니다.
- 공급사 샌드박스, 자격 증명, 재고 범위, 테스트 카드 설정
- 공통 흐름에서 검색, 요금 확인 또는 재검증, 예약, 발권 또는 확정 구현
- 마크업, 수수료, 기업 출장 규정, 에이전트 신용 한도 추가
- 요청 ID, 예약 로그, 오류 목록, 알림 추가
- 인증을 통과하고 운영 자격 증명으로 전환
- 공급사
- Hotelbeds · JSON
- 환경
- 샌드박스
- 엔드포인트
- sandbox.supplier-api.com/v1
- API 키
- ••••••••••••7c21
- 마크업
- 넷 요금에 8%
통합 결과
여러 API의 항공, 호텔, 렌터카를 하나의 목록으로
공급사마다 고유한 XML이나 JSON을 반환합니다. PHPTRAVELS는 객실, 운임, 규정, 가격을 정규화하고 마크업을 적용한 뒤 예약 전에 각 결과의 상태를 표시합니다.
- 라호르 → 두바이 · 직항일반석 · GDS 운임 · 위탁 수하물 1개US$175
- 두바이 마리나 호텔 · 3박더블룸 · 조식 포함 · 베드뱅크 요금US$486
- 소형차 · 두바이 공항3일 · 주행거리 무제한 · 렌터카 APIUS$132
모든 핵심 작업
검색, 요금 확인 또는 재검증, 예약, 발권, 취소, 환불을 모든 공급사에 같은 방식으로 연결합니다.
정규화된 콘텐츠
객실 유형, 요금제, 운임 규정, 세금, 취소 기한을 캐싱 전에 하나의 모델로 매핑합니다.
XML과 JSON
공급사가 제공하면 JSON REST, GDS와 베드뱅크가 아직 요구하면 공급사 XSD를 사용한 XML.
안전한 예약 재시도
예약 시 멱등성 키, 백오프 재시도, 공급사 장애 시 서킷 브레이커.
결제 API
3-DS 카드, 공급사용 가상 카드, 에이전트용 지갑을 각 예약에 연결합니다.
예약 후 서비스
변경, 취소, 환불, 재발권, 스케줄 변경을 관리자에서 처리하고 확정 시 바우처를 발행합니다.
연동 흐름
여행 API가 샌드박스에서 실제 예약까지 가는 과정
모든 공급사가 같은 단계를 거치므로, 고객이 콘텐츠를 보기 전에 흐름, 로그, 결제가 준비됩니다.
연결
샌드박스 접근, 인증, 테스트 데이터, 작동하는 기본 검색.
구현
공통 예약 흐름에서 요금 확인 또는 재검증, 예약, 발권 또는 확정.
결제
결제 승인, 매입, 환불 웹훅을 예약 ID에 매핑.
안정화
요청 ID, 로그, 오류 처리, 재시도, 공급사 장애 알림.
인증
합의된 테스트 케이스와 예약 시나리오로 공급사 인증 진행.
운영 전환
운영 자격 증명, 모니터링, 런북, 팀 인계.
여행 API 허브
계약한 모든 공급사를 위한 하나의 허브
공급사는 인증, 로깅, 재시도, 모니터링을 공유하는 하나의 레이어에 연결됩니다. 이용 가능 여부는 계약과 파트너 승인에 따라 다릅니다.
GDS와 항공 API
XML 기반 Amadeus, Sabre, Travelport와 Duffel, Kiwi, TBO 같은 JSON 항공 API.
호텔, 렌터카, 투어
Hotelbeds, Agoda, Hotelston 같은 베드뱅크, 렌터카용 CarTrawler, 액티비티용 Viator와 Tiqets.
결제 게이트웨이
매입, 환불, 예약 대사를 위한 Stripe, PayPal, 은행 API.
백오피스
모든 API를 하나의 관리자에서 운영
공급사별 가격, 권한, 결제, 기록이 같은 관리자에 있어 API를 추가해도 백오피스가 늘지 않습니다.
공급사 자격 증명
공급사별 샌드박스와 운영 키를 서버에 보관하고 환경별로 전환합니다.
마크업과 수수료
공급사, 상품, 목적지, 채널, 에이전트 그룹별 정액 또는 비율 규칙.
에이전트 신용과 지갑
B2B 에이전트는 귀사의 요금과 권한 안에서 신용 한도나 지갑 잔액으로 예약합니다.
결제 대사
결제 ID를 PNR과 예약 ID에 매핑하고 환불과 부분 매입을 자동화합니다.
요청 로그
모든 요청과 응답을 ID와 함께 저장해 고객 지원과 공급사 분쟁에 활용합니다.
공급사 리포트
공급사별·채널별 검색, 예약, 실패, 취소, 마진.
비교
공급사별 개별 개발 vs PHPTRAVELS API 허브
공급사가 하나라면 API별 개별 코딩도 가능합니다. 여러 곳이라면 공통 흐름이 새 연결마다 시간을 줄여 줍니다.
| 항목 | API별 개별 개발 | PHPTRAVELS |
|---|---|---|
| 예약 흐름 | API별 개별 개발공급사마다 다시 작성 | PHPTRAVELS모든 공급사에 하나의 검색, 요금, 예약, 환불 흐름 |
| 콘텐츠 매핑 | API별 개별 개발공급사마다 객실과 운임 형식이 다름 | PHPTRAVELS표시 전에 하나의 모델로 정규화 |
| 재시도와 로깅 | API별 개별 개발첫 장애 이후에 추가되는 경우가 많음 | PHPTRAVELS첫날부터 요청 ID, 재시도, 멱등 예약 |
| 결제 | API별 개별 개발게이트웨이와 흐름마다 별도 연동 | PHPTRAVELS환불 웹훅과 함께 예약에 연결된 결제 |
| 공급사당 기간 | API별 개별 개발내부 경험에 따라 다름 | PHPTRAVELS보통 인증 포함 2~4주 |
활용 사례
여행사, OTA, TMC를 위한 여행 API 연동
여행사 API
리테일 흐름, 바우처, 마크업, 수수료, 기본 에이전트 신용, 간단한 주문 관리.
OTA API
캐싱을 활용한 대량 검색, 예약 전 재검증, 비동기 큐, 호출 한도 대응.
TMC API
기업 프로필, 출장 규정, 승인, 신용 한도, 협상 요금, 리포트.
PHPTRAVELS를 선택하는 이유
직접 소유하고 확장할 수 있는 API 연동
소스 코드 포함
상용 라이선스로 자체 호스팅하므로 개발자가 모든 커넥터를 읽고 확장할 수 있습니다.
PHP로 구축
팀이 이미 아는 cURL 또는 Guzzle 클라이언트와 웹훅 핸들러를 쓰는 표준 PHP.
PCI 범위 축소
토큰화와 호스팅 결제 필드로 카드 데이터가 서버를 거치지 않습니다.
B2C, B2B, 기업
하나의 연동으로 공개 사이트, 에이전트 포털, 기업 예약자를 모두 지원합니다.
여행 웹사이트나 에이전트 포털을 공급사 API에 연결해 호텔, 항공, 렌터카, 액티비티를 자체 플랫폼에서 검색, 요금 확인, 예약, 관리할 수 있게 하는 것입니다. 대부분의 여행 API는 공급사 인증과 함께 HTTP 위에서 XML 또는 JSON을 사용합니다.
보통 공급사당 2~4주이며 샌드박스 설정, 핵심 예약 흐름, 결제, 인증, 운영 전환을 포함합니다. 범위와 공급사 인증 일정에 따라 달라질 수 있습니다.
JSON이 개발과 파싱이 더 빠르므로 공급사가 같은 기능을 제공하면 JSON을 우선합니다. 일부 GDS와 베드뱅크는 여전히 XSD가 있는 XML을 요구하며, 두 형식 모두 포털에서 같은 모델로 정규화됩니다.
여러 공급사를 인증, 로깅, 재시도, 모니터링을 공유하는 하나의 레이어로 연결하는 구조로, 새 공급사는 처음부터 만들지 않고 같은 흐름을 재사용합니다.
카드는 3-DS로 토큰화되고 발권 또는 바우처 발행 후 매입되며, 각 결제 ID가 PNR이나 예약 ID에 매핑되어 환불과 대사가 웹훅으로 처리됩니다.
GDS, 베드뱅크, 렌터카, 액티비티, 결제 API 등 폭넓게 연동합니다. 이용 가능 여부는 계약과 파트너 승인에 따르므로, 사용 중인 공급사를 알려 주시면 범위와 일정을 확인해 드립니다.