항공 API 연동
여행사를 위한 Kiwi API 연동
Tequila API를 통해 Kiwi.com 항공권 콘텐츠를 PHPTRAVELS 예약 사이트로 가져오세요. Kiwi.com이 여정을 반환하고 예약을 접수하며, PHPTRAVELS가 검색, 결제, 마크업, 여행사 관리자 화면을 운영합니다.
- 항공 카테고리의 Kiwi 모듈
- 편도, 왕복, 다구간
- 모든 Kiwi.com 운임에 마크업
- docs.phptravels.com 설정 가이드
작동 방식
자체 예약 플랫폼에서 판매하는 Kiwi.com 항공권
Kiwi API 연동은 두 가지를 연결합니다. 고객이 사용하는 예약 웹사이트와, 그 항공 검색 결과를 공급하는 Kiwi.com Tequila 계정입니다. PHPTRAVELS는 항공 카테고리에 Kiwi 모듈을 제공합니다. 관리자 화면에 AffilID와 API 키를 입력하면 모듈이 Tequila에서 이를 확인하고, 검색 결과에 마크업이 적용된 Kiwi.com 여정이 표시됩니다. Tequila 접근 권한은 Kiwi.com이 부여하므로 출시 계획 전에 계정을 확인하세요.
- Kiwi.com에 Tequila API 접근을 신청하고 AffilID와 API 키를 받습니다
- PHPTRAVELS 관리자에서 모듈을 열고 Kiwi 설정에 두 인증 정보를 입력합니다
- 저장해 인증 확인을 실행합니다. Tequila API에 실제 공항 조회를 보냅니다
- 마크업을 설정하고 성인, 소아, 유아 운임을 검토합니다
- 모든 고객에게 Kiwi.com 운임을 공개하기 전에 소수의 실제 예약으로 확인합니다
- 환경
- 운영 환경 전용
- AffilID
- youragency_affil
- 엔드포인트
- Tequila API v2 · api.tequila.kiwi.com
- API 키
- ••••••••••••••••
- 마크업
- Kiwi.com 운임에 6%
검색과 예약
검색 결과에는 Kiwi.com 여정, 관리자 화면에는 예약
각 Kiwi.com 결과에는 항공사, 운항 시간, 좌석 등급, 수하물 한도와 함께, 결제 단계가 바로 그 여정을 예약하는 데 필요한 예약 토큰이 담깁니다.
- Direct07:15 BCN → 08:40 STN직항 · 일반석 · 기내 수하물 10kgUS$64총액
- 1 stop10:05 BCN → 14:30 LHR1회 경유 · 일반석 · 위탁 수하물 20kgUS$118총액
- 18:50 BCN → 20:10 LGW직항 · 일반석 · 위탁 수하물 15kgUS$92총액
편도 및 왕복 검색
출발지, 도착지, 날짜, 승객, 좌석 등급, 통화가 Tequila 검색 엔드포인트로 전송되고, 일치하는 Kiwi.com 여정이 결과로 돌아옵니다.
다구간 여정
다구간 요청의 각 구간을 Kiwi.com에서 따로 검색한 뒤 결과를 하나의 여정 묶음으로 합칩니다.
좌석 등급
일반석, 프리미엄 일반석, 비즈니스, 일등석이 Kiwi.com이 요구하는 좌석 코드에 매핑됩니다.
결과에 수하물 한도 표시
Kiwi.com의 위탁 및 기내 수하물 무게가 운임마다 표시되어 고객이 같은 기준으로 비교합니다.
마크업과 승객별 요금
마크업이 Kiwi.com 가격에 더해지고, 성인·소아·유아 요금이 공급사 원가와 함께 저장됩니다.
토큰으로 예약
확정 시 모듈이 예약 토큰과 승객 정보를 Tequila 예약 엔드포인트로 보냅니다.
예약 흐름
Kiwi.com 검색에서 예약 확정까지
고객 결제 이후의 과정까지 포함한, Kiwi.com 운임 하나가 사이트에서 거치는 흐름입니다.
검색
고객의 여정, 승객, 좌석 등급이 Kiwi.com으로 전송되고 선택지가 돌아옵니다.
가격
마크업이 적용되고 고객이 고른 통화로 운임이 표시됩니다.
결제
승객별로 이름, 성, 호칭, 국적, 이메일, 전화번호를 받습니다.
예약
예약 토큰과 승객 명단을 Kiwi.com에 보내 예약을 생성합니다.
예약 후
취소와 환불은 API가 아닌 Kiwi.com 고객지원을 통해 요청합니다.
역할 분담
Kiwi API 연동에서 누가 무엇을 하는가
Kiwi.com 연결을 운영하려면 예약 플랫폼, 승인된 Tequila 계정, 여행사의 사후 서비스 절차가 필요합니다.
PHPTRAVELS: 예약 플랫폼
웹사이트, Kiwi 모듈 설정, 마크업, 결제, 예약 관리. 그 밖의 B2C·B2B 도구는 패키지에 따라 다릅니다.
Kiwi.com: 항공 콘텐츠
Tequila API를 통한 여정, 가격, 예약. 접근 권한, 노선, 예약 후 규정은 Kiwi.com과 항공사가 정합니다.
귀사: 상업 운영
판매가, 고객 결제, 고객 지원. 승객이 취소나 변경을 요청할 때 누가 Kiwi.com에 연락할지도 포함됩니다.
연결할 수 있는 항공 공급사:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
백오피스
관리자 화면에서 Kiwi.com 항공권 판매 운영
Kiwi.com 예약의 인증 정보, 가격, 사후 서비스 규칙을 다른 여행 사업과 같은 대시보드에서 관리합니다.
모듈 설정
AffilID와 API 키를 모듈에 저장하고, 키 누락, 무효, 호출 한도 초과를 즉시 확인해 알려 줍니다.
마크업과 공급사 원가
각 예약에 마크업된 판매가와 Kiwi.com 가격을 함께 저장해 예약별 마진을 볼 수 있습니다.
통화
검색은 고객 통화로 가격을 요청하고, 같은 통화가 예약 데이터와 함께 저장됩니다.
취소 요청
Kiwi.com은 API로 취소하지 않으므로, 관리자 화면이 해당 예약을 표시해 담당자가 Kiwi.com 고객지원에 요청하게 합니다.
B2C 및 B2B 채널
Kiwi.com 운임을 공개 사이트, 에이전트, 또는 둘 다에 제공할지 정하고 채널별 가격을 검증하세요.
추가 워크플로
추가 수하물, 좌석 선택 등 모듈 범위 밖 단계는 연동 커스터마이징으로 견적을 낼 수 있습니다.
비교
Kiwi.com API로 직접 구축 vs PHPTRAVELS
Kiwi.com은 항공 API를 제공할 뿐, 그 주변의 예약 제품은 따로 필요합니다. 직접 개발할 때 일반적으로 필요한 작업을 PHPTRAVELS와 비교했습니다.
| 항목 | Tequila 기반 자체 개발 | PHPTRAVELS |
|---|---|---|
| 고객용 웹사이트 | Tequila 기반 자체 개발검색, 결과, 결제를 처음부터 설계하고 개발 | PHPTRAVELS브랜드 항공권 검색, 결과, 결제가 이미 준비됨 |
| Kiwi.com 연결 | Tequila 기반 자체 개발검색, 다구간, 예약 호출을 직접 작성하고 테스트 | PHPTRAVELS인증 확인과 마크업을 갖춘 기존 Kiwi 모듈 |
| 관리와 마진 | Tequila 기반 자체 개발예약 관리 화면과 가격 규칙을 새로 개발해야 함 | PHPTRAVELS예약, 공급사 원가, 판매가를 하나의 대시보드에서 |
| 에이전트 채널 | Tequila 기반 자체 개발B2B 포털은 별도 프로젝트 | PHPTRAVELS패키지에 따라 플랫폼 내 B2B·B2C 도구 제공 |
| 다른 공급사 | Tequila 기반 자체 개발새 항공 소스나 상품마다 추가 개발 | PHPTRAVELS같은 설치에서 다른 항공, 호텔, 투어, 렌터카 모듈 |
활용 사례
Kiwi.com을 PHPTRAVELS에 연결하는 곳
신규 온라인 여행사
Kiwi.com 여정을 첫 콘텐츠 소스로 항공권 예약 사이트를 출시하고, 이후 공급사를 추가하세요.
저가·레저 여행사
운임마다 수하물 한도를 명확히 보여 주며 단거리와 레저 노선을 자체 패키지와 함께 판매하세요.
B2B 에이전트 네트워크
패키지 범위 내에서 파트너 에이전트별 접근 권한과 가격 규칙으로 Kiwi.com 운임을 제공하세요.
PHPTRAVELS를 선택하는 이유
Kiwi.com 계정, 플랫폼, 코드 모두 귀사의 것
소스 코드 포함
상용 라이선스로 자체 호스팅하여 개발자가 Kiwi.com 흐름을 확장할 수 있습니다.
귀사의 Tequila 인증 정보
AffilID와 API 키는 귀사가 보유하며 자체 설치에 저장됩니다.
문서화된 설정
docs.phptravels.com 항공 섹션의 Kiwi 모듈 가이드.
B2C와 B2B
공개 웹사이트와 에이전트 포털을 하나의 설치로, 24개 언어 지원.
항공 카테고리의 Kiwi 모듈을 통해 Kiwi.com Tequila API를 PHPTRAVELS 예약 플랫폼에 연결하는 것입니다. Kiwi.com이 여정을 제공하고 예약을 접수하며, PHPTRAVELS가 고객용 웹사이트, 마크업, 여행사 관리를 제공합니다.
Tequila 접근 권한은 Kiwi.com이 부여합니다. 승인되면 AffilID와 API 키를 받아 Kiwi 모듈 설정에 입력합니다. 자격 요건과 상업 조건은 Kiwi.com에 직접 확인하세요.
이 모듈은 Kiwi.com 운영 API에서만 작동하며 예시 키는 거부합니다. 고객에게 공개하기 전에 소수의 실제 예약으로 검증하거나 Kiwi.com 운임을 직원 계정으로만 제한하세요.
네. 편도와 왕복은 한 번의 검색을 사용하고, 다구간 요청은 각 구간을 Kiwi.com에서 따로 검색해 결과를 합칩니다.
아니요. 모듈이 사용하는 Kiwi.com API는 취소나 환불을 제공하지 않습니다. 담당자가 Kiwi.com 고객지원에 요청하며, 가능 여부는 Kiwi.com과 항공사 규정을 따릅니다.
완전히 같다고 가정하지 마세요. 추가 수하물, 좌석 선택 등은 사용 중인 PHPTRAVELS 버전과 Kiwi.com 계정에서 확인해야 하며, 커스터마이징으로 추가할 수 있습니다.
