항공 API 연동
여행사를 위한 Duffel API 연동
Duffel 항공 콘텐츠를 PHPTRAVELS 예약 플랫폼으로 가져오세요. Duffel은 계정에서 이용 가능한 오퍼와 주문을 제공하고, PHPTRAVELS는 웹사이트, 결제, 마크업, 여행사 관리자를 운영합니다.
- 기존 Duffel 항공 모듈
- NDC, GDS, 저비용 항공 콘텐츠
- 여행사 마크업 설정
- 실운영 전 테스트 모드
작동 방식
Duffel 항공편과 연결된 예약 플랫폼
Duffel API 연동은 두 가지 결정을 분리합니다. 고객이 사용하는 예약 플랫폼과 항공 검색 결과를 공급하는 공급사 계정입니다. PHPTRAVELS는 항공 카테고리에 API 자격 증명과 마크업 설정을 갖춘 Duffel 모듈을 제공하며, docs.phptravels.com의 설정 가이드에서 API 접근과 첫 검색을 안내합니다. 이 연결로 시작한 뒤, 출시에 필요한 예약과 사후 서비스 범위를 팀과 합의하세요.
- Duffel 계정을 만들고 판매 시장과 콘텐츠 접근 권한을 확인
- 시험 구성을 위해 Duffel 테스트 액세스 토큰 준비
- PHPTRAVELS 관리자에서 모듈을 열고 Duffel 설정에 자격 증명 입력
- 마크업을 설정하고 검색, 승객 정보, 결제, 주문 확인을 검증
- Duffel 활성화 요건을 완료하고 실운영 자격 증명으로 전환
- 환경
- 테스트 모드
- 엔드포인트
- Duffel API · api.duffel.com
- 액세스 토큰
- duffel_test_••••••••
- 마크업
- Duffel 운임에 8%
오퍼와 주문
검색에는 Duffel 오퍼, 관리자에는 주문
Duffel API는 오퍼와 주문으로 작동합니다. 각 결과에는 고객이 비교하는 운임 정보와 예약 프로세스가 의존하는 상태가 표시됩니다.
- NDC08:25 LHR → 11:30 JFK직항 · 이코노미 · 위탁 수하물 1개US$486총액
- GDS12:10 LHR → 15:20 JFK직항 · 프리미엄 이코노미 · 좌석 선택US$912총액
- 17:40 LHR → 23:55 JFKDUB 경유 1회 · 이코노미 · 기내 수하물만US$455총액
항공 오퍼 검색
여정과 승객 조건이 Duffel로 전송되고, 계정에서 이용 가능한 오퍼가 검색 결과로 돌아옵니다.
결제 전 오퍼 확인
검색 후 좌석과 가격이 바뀔 수 있으므로 선택한 오퍼를 결제 전에 다시 조회합니다.
승객 정보
결제 단계에서 Duffel이 주문 생성에 필요한 승객 정보를 받고, 합의된 결제 절차를 따릅니다.
주문과 예약번호
반환된 주문과 항공사 예약번호를 확인한 뒤 고객에게 확정 안내를 보냅니다.
모듈 마크업
Duffel 모듈 설정에서 마크업을 지정해 표시되는 판매가에 마진이 포함됩니다.
테스트와 실운영 분리
Duffel 테스트 모드는 샌드박스 콘텐츠와 테스트 자격 증명을 사용하며 실운영 리소스와 분리됩니다.
예약 흐름
Duffel 검색부터 확정된 주문까지
고객 결제에서 공급사 확정으로 넘어가는 과정을 포함해, 구성한 연결을 이 흐름으로 평가하세요.
검색
여정과 승객을 Duffel에 보내고 항공 오퍼를 받습니다.
검토
선택한 오퍼를 다시 조회해 가격과 좌석을 최신으로 유지합니다.
예약
승객 정보와 결제를 받은 뒤 Duffel에서 주문을 생성합니다.
확정
주문과 항공사 예약번호를 확인하고 고객에게 확정합니다.
사후 서비스
변경과 취소는 항공사 규정과 합의된 범위를 따릅니다.
역할 분담
Duffel 연동에서 각 주체가 하는 일
제대로 작동하는 연결에는 플랫폼, 승인된 공급사 계정, 여행사 운영 프로세스가 필요합니다. 출시일을 정하기 전에 세 가지를 모두 정의하세요.
PHPTRAVELS: 예약 플랫폼
웹사이트, Duffel 모듈 설정, 마크업 구성, 예약 관리. 패키지에 따라 추가 B2B 및 B2C 도구가 정해집니다.
Duffel: 항공 연결
API를 통한 항공사 오퍼와 주문 서비스. 항공사, 콘텐츠, 예약 후 작업은 Duffel, 항공사, 계정에 따라 다릅니다.
여행사: 상업 워크플로
공급사 온보딩, 판매가, 고객 결제와 지원. 대기 중인 예약과 여행자 요청을 누가 처리할지도 포함합니다.
연결할 수 있는 항공 공급사:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
백오피스
관리자에서 Duffel 항공권 판매 운영
Duffel 예약의 설정, 가격, 운영 규칙을 여행 사업의 다른 업무와 같은 대시보드에서 관리합니다.
모듈 설정
모듈 메뉴에서 Duffel API 자격 증명을 입력하고 테스트와 실운영 구성을 분리합니다.
마크업과 판매가
여행사 마크업을 저장하고 최종 가격을 공급사 수수료, 통화, 결제 비용과 대조합니다.
B2C와 B2B 채널
Duffel을 먼저 적용할 채널을 정한 뒤 에이전트 접근, 가격, 결제를 검증합니다.
미해결 주문
직원이 확정되지 않은 공급사 주문을 찾는 명확한 절차로, 결제를 발권 완료로 오인하지 않게 합니다.
별도의 비용 항목
라이선스, 호스팅, 결제 처리, 맞춤 개발, Duffel 수수료를 각각의 예산 항목으로 계획합니다.
추가 워크플로
모듈 범위를 넘는 좌석, 유료 수하물, 사후 서비스는 연동 맞춤 개발로 범위를 정할 수 있습니다.
비교
Duffel API로 직접 개발 vs PHPTRAVELS
Duffel은 항공 API를 제공하지만, 그 주변의 예약 제품은 여전히 필요합니다. 직접 개발에 일반적으로 필요한 작업을 PHPTRAVELS와 비교했습니다.
| 항목 | Duffel 기반 직접 개발 | PHPTRAVELS |
|---|---|---|
| 고객용 웹사이트 | Duffel 기반 직접 개발검색, 결과, 결제를 처음부터 설계하고 개발 | PHPTRAVELS자체 브랜드의 항공 검색, 결과, 결제가 이미 준비됨 |
| Duffel 연결 | Duffel 기반 직접 개발오퍼와 주문 호출을 개발자가 작성하고 테스트 | PHPTRAVELS자격 증명과 마크업 설정을 갖춘 기존 Duffel 모듈 |
| 관리자와 마크업 | Duffel 기반 직접 개발예약 관리자와 가격 규칙을 새로 개발해야 함 | PHPTRAVELS예약 관리와 모듈 마크업을 하나의 대시보드에서 |
| 에이전트 채널 | Duffel 기반 직접 개발B2B 포털은 별도 프로젝트 | PHPTRAVELS패키지에 따라 플랫폼에 B2B와 B2C 도구 포함 |
| 다른 상품 | Duffel 기반 직접 개발새 공급사나 상품마다 추가 개발 | PHPTRAVELS호텔, 투어, 렌터카 등 공급사 모듈을 같은 설치본에서 |
활용 사례
Duffel을 PHPTRAVELS에 연결하는 곳
새로운 온라인 여행사
첫날부터 Duffel 콘텐츠로 자체 브랜드 항공 예약 사이트를 열고, 이후 다른 상품을 추가하세요.
IATA 인가가 없는 여행사
요건을 충족하는 사업자는 Duffel의 승인을 전제로 Duffel의 인가와 발권 권한 아래 Duffel Managed Content를 이용할 수 있습니다.
B2B 에이전트 네트워크
파트너 에이전트에게 고유한 접근 권한과 가격 규칙으로 Duffel 항공편을 제공합니다. 세부 사항은 패키지에 맞춰 정합니다.
PHPTRAVELS를 선택하는 이유
내 Duffel 계정, 내 플랫폼, 내 코드
소스 코드 포함
상업용 라이선스로 자체 호스팅하므로 개발자가 Duffel 흐름을 확장할 수 있습니다.
내 Duffel 자격 증명
Duffel 계정과 액세스 토큰은 고객 소유이며 자체 설치본에 저장됩니다.
문서화된 설정
docs.phptravels.com의 Duffel 설정 가이드가 API 접근과 첫 검색을 안내합니다.
B2C와 B2B
공개 웹사이트와 에이전트 포털을 하나의 설치본으로, 24개 언어로 운영합니다.
Duffel 항공 공급사 모듈을 PHPTRAVELS 예약 플랫폼에 연결하는 것입니다. Duffel 계정은 이용 가능한 항공 콘텐츠에 대한 접근을 제공하고, PHPTRAVELS는 고객용 웹사이트와 여행사 관리를 제공합니다.
네. PHPTRAVELS는 항공 카테고리에 Duffel 모듈을 등재하고 API 접근과 첫 검색을 다루는 설정 가이드를 공개하고 있습니다. 출시 전에 설치된 버전과의 호환성과 필요한 예약 작업을 확인하세요.
Duffel 계정을 만들고 API 자격 증명을 받은 뒤 PHPTRAVELS 관리자의 Duffel 모듈 설정에 입력합니다. 마크업을 구성하고 실운영으로 전환하기 전에 테스트 모드에서 연동을 검증하세요.
Duffel은 계정 활성화와 이용 가능한 콘텐츠를 조건으로 자체 인가와 발권 권한을 사용하는 Managed Content를 제공합니다. 자격 여부는 Duffel에 확인하세요. PHPTRAVELS를 연결한다고 해서 회사가 IATA 인가를 받는 것은 아닙니다.
기능이 완전히 같다고 가정하지 마세요. 좌석, 유료 수하물, 변경, 취소 등 사후 서비스 작업은 PHPTRAVELS 모듈 버전, 항공사 지원, 합의된 연동 범위에 맞춰 확인해야 합니다.
아니요. Duffel 테스트 모드는 샌드박스 콘텐츠와 테스트 자격 증명을 사용합니다. 동작 검증에는 유용하지만 테스트 결과는 실제 좌석 현황이나 상업적 운임 견적이 아닙니다.
