항공 API 연동
여행사와 OTA를 위한 PKFARE API 연동
PKFARE 항공 콘텐츠를 자체 예약 사이트와 에이전트 포털에서 판매하세요. PKFARE는 운임을 제공하고 주문을 생성하며, PHPTRAVELS는 하나의 관리자 화면에서 검색, 체크아웃, 마크업, 결제, PNR 기록, 사후 관리를 처리합니다.
- 편도, 왕복, 다구간
- 모든 운임에 환불 규정과 수하물
- 결제 후 주문과 PNR
- docs.phptravels.com 설정 가이드
작동 방식
자체 예약 엔진 안의 PKFARE 항공편
PKFARE API 연동은 고객과 에이전트가 사용하는 예약 사이트를 항공 검색 결과를 제공하는 PKFARE 계정과 연결합니다. PHPTRAVELS는 항공 카테고리에 PKFARE 모듈을 제공합니다. partner ID와 API key를 입력하면 모든 요청이 이 값으로 서명되고, 검색 시 마크업과 통화가 적용된 PKFARE 운임이 반환됩니다. 결제가 확인되면 예약이 PKFARE로 전송되고 주문 번호와 PNR이 예약에 저장됩니다. 접근 권한과 상업 조건은 PKFARE가 정하므로 출시 계획 전에 계정을 확인하세요.
- PKFARE와 접근 권한과 범위를 협의하고 partner ID와 API key를 받습니다
- PHPTRAVELS 관리자에서 모듈을 열고 PKFARE 설정에 두 값을 입력합니다
- 마크업과 통화를 설정하고 성인, 소아, 유아 요금을 확인합니다
- 실제 예약 몇 건으로 검색, 결제, PNR, 취소를 테스트합니다
- PKFARE 운임을 B2C 사이트, 에이전트 또는 둘 다에 공개합니다
- 환경
- 운영 환경
- Partner ID
- youragency_partner
- 엔드포인트
- api.pkfare.com · 검색 및 예약
- API key
- ••••••••••••••••
- 마크업
- B2C 7% · 에이전트 4%
검색과 운임
규정, 수하물, 승객별 요금이 포함된 PKFARE 운임
각 PKFARE 결과에는 여행자가 결제 전에 비교하는 정보가 표시됩니다. 운항 시간, 경유, 좌석 등급, 위탁 및 기내 수하물, 환불 규정, 판매가입니다.
- Direct08:05 HKG → 11:55 SIN직항 · 일반석 · 위탁 30 kg · 기내 7 kgUS$412총액
- 1 stop13:20 HKG → 21:45 SINKUL 1회 경유 · 일반석 · 위탁 20 kgUS$338총액
- 19:40 HKG → 23:30 SIN직항 · 비즈니스석 · 위탁 40 kgUS$1,184총액
편도와 왕복 검색
출발지, 도착지, 날짜, 승객, 좌석 등급, 통화가 PKFARE 검색 API로 전송되고 일치하는 운임이 결과로 돌아옵니다.
한 번의 요청으로 다구간 검색
PKFARE는 여러 구간을 한 번에 받으므로 다구간 여정을 한 번의 호출로 검색하고 하나의 여정으로 요금을 산정합니다.
네 가지 좌석 등급
일반석, 프리미엄 일반석, 비즈니스석, 일등석을 PKFARE가 요구하는 값으로 매핑합니다.
결과에 수하물 표시
PKFARE의 위탁 및 기내 수하물 허용량이 운임마다 표시되어 고객이 같은 조건으로 비교합니다.
결제 전에 환불 여부 확인
PKFARE 운임 규정에 따라 각 결과를 환불 가능 또는 수수료 있음으로 표시하며, 고객은 체크아웃 전에 확인합니다.
승객별 마크업과 통화
성인, 소아, 유아의 운임과 세금에 각각 마크업을 적용하고 고객 통화로 따로 환산합니다.
예약 흐름
PKFARE 검색부터 PNR이 있는 주문까지
PKFARE 운임 하나가 사이트에서 거치는 과정으로, 고객 결제 이후의 처리도 포함합니다.
검색
여정, 승객, 좌석 등급이 PKFARE로 전송되고 운임이 돌아옵니다.
가격 산정
승객 유형별로 마크업과 통화가 적용됩니다.
체크아웃
여행자 이름, 여권 정보, 연락처를 입력받습니다.
결제
고객은 결제 게이트웨이로, 에이전트는 지갑에서 결제합니다.
예약
결제 후 예약이 PKFARE로 전송되고 주문 번호와 PNR이 저장됩니다.
취소
관리자에서 주문 번호로 PKFARE에 취소를 요청하며 PKFARE 규정을 따릅니다.
역할 분담
PKFARE API 연동에서 누가 무엇을 맡나
PKFARE 연결이 제대로 작동하려면 예약 플랫폼, 승인된 PKFARE 계정, 여행사의 사후 관리 프로세스가 필요합니다.
PHPTRAVELS: 예약 플랫폼
웹사이트, 에이전트 포털, PKFARE 모듈 설정, 마크업, 체크아웃, 결제, 예약 관리.
PKFARE: 항공 콘텐츠
운임, 좌석 가용성, 운임 규정, 주문, PNR. 접근 권한, 노선, 발권 조건은 PKFARE와 항공사가 정합니다.
여행사: 상업 운영
판매가, 고객 결제, 고객 지원. 변경과 환불은 PKFARE와 항공사 규정을 따릅니다.
연결할 수 있는 항공 공급사:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
백오피스
관리자에서 PKFARE 항공권 판매 운영
PKFARE 인증 정보, 가격, 예약 기록을 다른 여행 사업과 같은 대시보드에서 관리합니다.
모듈 설정
Partner ID와 API key는 자체 설치본의 모듈에 저장되며 고객에게 표시되지 않습니다.
마크업과 공급 원가
각 예약에 판매가와 PKFARE 운임 및 세금을 함께 저장해 예약별 마진을 확인할 수 있습니다.
주문과 PNR 기록
주문 번호, PNR, 승객, 결제 상태, PKFARE 전체 응답이 예약과 함께 저장됩니다.
중복 주문 방지
이미 확정된 PNR이 있는 예약은 결제를 다시 시도해도 PKFARE로 다시 전송되지 않습니다.
B2B 에이전트 판매
에이전트는 에이전트 포털에서 자체 마크업과 지갑 잔액으로 PKFARE 운임을 예약합니다.
예약 관리
직원은 예약 번호로 예약을 찾아 승객, 여정, 결제, 메모를 별도 포털이 아닌 한곳에서 확인합니다.
비교
PKFARE 항공편을 판매하는 방법
적합한 방식은 고객 여정과 백오피스를 얼마나 직접 소유하고 싶은지에 따라 다릅니다. 일반적인 선택지는 대체로 다음과 같이 비교됩니다.
| 항목 | 공급사 포털 또는 자체 개발 | PHPTRAVELS |
|---|---|---|
| 검색 | 공급사 포털 또는 자체 개발직원이 공급사 포털에서 운임을 확인해 견적에 복사 | PHPTRAVELS자사 브랜드 검색과 에이전트 포털에 PKFARE 운임 표시 |
| 가격 | 공급사 포털 또는 자체 개발마크업을 수작업으로 더하거나 처음부터 개발 | PHPTRAVELS승객 유형별 마크업과 통화 규칙 적용 |
| 예약 | 공급사 포털 또는 자체 개발승객 정보를 공급사 포털에 다시 입력 | PHPTRAVELS결제 후 주문과 PNR 자동 생성 |
| 기록 | 공급사 포털 또는 자체 개발공급사 기록과 내부 메모가 분리 | PHPTRAVELS관리자, 고객, 에이전트가 함께 쓰는 하나의 예약 기록 |
| 출시 기간 | 공급사 포털 또는 자체 개발자체 개발은 사이트, 관리자, 정산 흐름까지 직접 구축해야 함 | PHPTRAVELS완전한 예약 플랫폼에 포함된 기존 PKFARE 모듈 |
활용 사례
PKFARE를 PHPTRAVELS에 연결하는 곳
B2C 항공권 예약 사이트
공개 항공 검색, 온라인 카드 결제, 고객 계정, 예약 내역을 하나의 브랜드 사이트에서 제공합니다.
B2B 에이전트 유통
여행사와 콘솔리데이터를 위한 하위 에이전트 로그인, 전용 마크업, 지갑 또는 신용 결제.
항공과 호텔, 투어 결합
OTA와 투어 운영사가 PKFARE 항공편을 호텔, 투어, 픽업과 하나의 여정으로 묶습니다.
PHPTRAVELS를 선택하는 이유
PKFARE 계정, 플랫폼, 코드 모두 귀사의 것
소스 코드 포함
상용 라이선스로 자체 호스팅하므로 개발자가 PKFARE 흐름을 확장할 수 있습니다.
귀사의 PKFARE 인증 정보
partner ID와 API key는 귀사가 보유하며 자체 설치본에 저장됩니다.
문서화된 설정
docs.phptravels.com 항공 섹션의 PKFARE 모듈 가이드.
B2C와 B2B
공개 웹사이트와 에이전트 포털을 하나의 설치본으로, 24개 언어로 운영합니다.
항공 카테고리의 PKFARE 모듈을 통해 PKFARE 항공 콘텐츠를 PHPTRAVELS 예약 플랫폼에 연결해, 고객과 에이전트가 자체 사이트에서 검색하고 운임 규정을 확인하고 결제한 뒤 PNR을 받을 수 있게 합니다.
접근 권한은 PKFARE가 부여합니다. 승인 후 partner ID와 API key를 받아 PKFARE 모듈 설정에 입력합니다. 자격 요건과 상업 조건은 PKFARE에 직접 확인하세요.
공급사 로그인은 빠른 조회에 유용하지만 브랜드 예약 엔진, 자체 체크아웃, 에이전트 마크업, 인보이스, 고객 계정은 제공하지 않습니다. 많은 여행사가 지원용으로 로그인을 유지하고 판매는 연동을 통해 합니다.
주문 번호와 PNR이 예약에 저장되므로 직원은 관리자에서 승객, 여정, 결제 상태, 메모를 확인합니다. 취소는 주문 번호로 PKFARE에 전송되며, 취소·변경·환불 가능 여부는 PKFARE와 항공사 규정을 따릅니다.
네. 편도, 왕복, 다구간 검색을 지원하며 다구간 구간은 한 번의 요청으로 PKFARE에 전송됩니다.
플랜과 활성화하는 제품에 따라 다릅니다. 플랜은 일회성 라이선스인 Startup $2499부터 시작합니다. 가격 페이지를 보거나 영업팀에 견적을 요청하세요. PKFARE의 상업 조건은 PKFARE와 협의합니다.