호텔 API 연동
호텔 예약 웹사이트를 위한 Agoda API 연동
Agoda 파트너 계정을 PHPTRAVELS에 연결하고 자체 계약 호텔과 함께 Agoda의 호텔과 숙소를 판매하세요. 실시간 요금과 객실 현황, 결제 전 가격 확인, 예약 확정, 바우처, 취소까지 지원합니다.
- 실시간 요금과 객실 현황
- 호텔, 홈, 아파트
- 모든 요금에 마크업
- 문서의 설정 가이드
작동 방식
숙박 모듈에 포함된 Agoda 커넥터
Booking Holdings 계열의 Agoda는 아시아를 비롯한 여러 지역에 방대한 호텔과 휴가용 임대 숙소를 보유한 온라인 여행 플랫폼입니다. PHPTRAVELS는 숙박 카테고리용 Agoda 모듈을 기본 제공하며, 고객님의 자격 증명으로 Agoda 파트너 API를 호출해 검색, 가격 확인, 예약, 바우처, 취소를 다른 호텔 공급업체와 같은 흐름에서 처리합니다. 설정 방법은 PHPTRAVELS 문서의 동영상에서 단계별로 안내합니다.
- Agoda 파트너 프로그램에 가입하고 사이트 ID와 API 키 발급
- 관리자에서 Agoda 모듈을 활성화하고 자격 증명 입력
- 마크업과 판매할 도시 및 통화 설정
- 운영 전 검색, 가격 확인, 예약, 취소 테스트
- 모듈을 운영 모드로 전환하면 검색 결과에 Agoda 객실 표시
- 환경
- 샌드박스
- 엔드포인트
- Agoda 파트너 API
- 자격 증명
- 사이트 ID: •••• · API 키: ••••
- 마크업
- Agoda 요금에 10%
- 시장 및 통화
- TH, MY, SG · USD
검색과 예약
모든 결과에 Agoda 객실의 가격, 정책, 상태 표시
각 Agoda 결과에는 고객이 비교하는 객실, 식사, 취소 정보와 예약 흐름에 필요한 상태가 담겨 있습니다.
- 4★Riverside Grand Hotel디럭스 리버뷰 · 조식 포함US$312숙박 기준
- 5★Sukhumvit Park Residence이그제큐티브 스위트 · 객실만US$468숙박 기준
- Silom Loft Apartment원베드룸 홈 · 객실만US$205숙박 기준
호텔 및 도시 매핑
Agoda 도시와 숙소를 목적지에 매핑해 한 번의 검색으로 Agoda와 자체 호텔을 함께 보여줍니다.
결제 전 가격 확인
고객 결제 전에 선택한 객실을 Agoda에서 다시 견적해 확정된 금액대로 청구합니다.
취소 정책
환불 가능 기한, 수수료, 환불 불가 요금을 예약 전에 보여주고 바우처에 인쇄합니다.
타임아웃과 재시도
예약 호출을 안전하게 재시도해 응답이 느려도 중복 예약이 생기지 않습니다.
공급업체 로그
Agoda 요청, 응답, 오류를 관리자에 기록해 지원과 감사에 활용합니다.
다중 통화
환율과 반올림 규칙에 따라 고객 통화로 Agoda 요금을 표시합니다.
예약 흐름
Agoda 검색부터 바우처와 취소까지
PHPTRAVELS가 모든 Agoda 예약에 실행하는 단계로, 공개 사이트와 에이전트 포털에서 동일합니다.
검색
도시, 날짜, 인원별 Agoda 객실 현황을 다른 호텔과 함께 표시.
가격 확인
결제 전 선택 객실을 재견적하고 정책을 갱신.
결제
고객 정보 입력 후 카드, 월렛, 오프라인 방식으로 결제.
확정
예약을 Agoda로 전송하고 예약 번호를 예약 정보에 저장.
바우처
Agoda 예약 번호와 정책이 담긴 바우처를 고객에게 이메일로 발송.
취소 또는 환불
요금 정책에 따라 취소하고 환불은 관리자에서 처리.
인벤토리
다른 호텔 공급원과 나란히 Agoda
Agoda는 숙박 모듈의 공급업체 중 하나이므로 객실이 자체 계약 및 다른 베드뱅크와 같은 검색에 나타납니다.
Agoda 호텔과 홈
Agoda 파트너 계정의 호텔, 리조트, 아파트, 홀리데이 홈.
기타 호텔 API
Hotelbeds, Hotelston, RateHawk, Stuba 등 숙박 공급업체, 각각 별도의 마크업 규칙 적용.
자체 계약
직접 계약한 호텔을 관리자에 등록하거나 파트너가 엑스트라넷에서 관리.
연결 가능한 호텔 공급업체:
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
백오피스
하나의 관리자에서 Agoda 판매 운영
Agoda 예약의 마진, 에이전트, 결제, 공급업체 기록을 다른 모든 상품과 같은 대시보드에서 관리합니다.
마크업과 수수료
Agoda 요금에 도시, 호텔, 채널별로 정액 또는 정률 적용.
B2B 에이전트
에이전트는 자체 요금으로 Agoda 호텔을 예약하고 신용 한도나 월렛으로 결제.
결제
카드 또는 오프라인 결제를 예약에 기록하고 취소 시 환불.
공급업체 예약 번호
Agoda 예약 번호로 예약을 찾고 클릭 한 번으로 바우처 재발송.
알림
예약 실패, 결제 시 가격 변동, 공급업체 오류 알림.
보고서
Agoda 예약, 마진, 지급 예정액을 내보내기 가능한 형태로.
비교
Agoda 커넥터 자체 개발과 PHPTRAVELS 비교
일부 팀은 Agoda API 호출을 직접 작성하며 시작합니다. 일반적으로 필요한 작업을 기본 제공 모듈과 비교했습니다.
| 항목 | 자체 개발 | PHPTRAVELS |
|---|---|---|
| 예약 흐름 | 자체 개발검색, 가격 확인, 예약, 취소 호출을 개발자가 직접 작성하고 테스트 | PHPTRAVELS검색, 가격 확인, 확정, 바우처, 취소가 숙박 모듈에 내장 |
| 콘텐츠 매핑 | 자체 개발프로젝트마다 Agoda 도시와 호텔을 수작업 매핑 | PHPTRAVELS관리자에서 도시와 호텔을 목적지에 매핑 |
| 타임아웃과 오류 | 자체 개발재시도를 설계하지 않으면 중복 예약 가능 | PHPTRAVELS모든 예약 호출에 안전한 재시도와 오류 기록 |
| 웹사이트와 에이전트 | 자체 개발예약 사이트와 에이전트 포털을 새로 구축해야 함 | PHPTRAVELS같은 설치본에 B2C 웹사이트와 B2B 에이전트 포털 |
| 설정 | 자체 개발누군가 작성한다면 내부 메모 | PHPTRAVELSPHPTRAVELS 문서의 동영상 설정 가이드 |
| 공급업체 추가 | 자체 개발새 공급업체마다 별도 프로젝트 | PHPTRAVELS같은 관리자에서 다른 호텔, 항공, 렌터카 API 추가 |
활용 사례
PHPTRAVELS로 Agoda를 판매하는 곳
온라인 여행사
자체 브랜드로 아시아태평양의 방대한 호텔 인벤토리를 직판 상품과 함께 판매.
B2B 여행사
하위 에이전트가 에이전트 포털에서 자체 요금으로 Agoda 호텔과 홈을 예약.
DMC와 투어 운영사
Agoda 숙박을 투어, 픽업, 항공과 결합해 패키지로.
PHPTRAVELS를 선택하는 이유
Agoda 계정, 플랫폼, 코드 모두 고객님의 것
소스 코드 포함
상용 라이선스로 셀프 호스팅하므로 개발자가 Agoda 흐름을 확장할 수 있습니다.
고객님의 Agoda 자격 증명
파트너 계약과 키는 고객님 소유이며 자체 설치본에 저장됩니다.
24개 언어
오른쪽에서 왼쪽으로 쓰는 언어를 포함해 각 시장의 언어와 통화로 Agoda 숙박 판매.
B2C와 B2B
공개 웹사이트와 에이전트 포털을 하나의 설치본으로.
Agoda 파트너 계정을 PHPTRAVELS 숙박 모듈에 연결해 고객과 에이전트가 Agoda의 실시간 요금과 객실 현황을 검색하고, PHPTRAVELS가 가격 확인, 예약, 바우처, 취소를 처리합니다.
기본 제공입니다. Agoda는 숙박 카테고리의 기본 모듈이며 PHPTRAVELS 문서에 동영상 설정 가이드가 있어, 개발을 의뢰하지 않고 활성화 후 자격 증명만 입력하면 됩니다.
네. Agoda 파트너 프로그램에 신청해 고유한 사이트 ID와 API 키를 받습니다. 계정에서 이용 가능한 상품과 예약 권한은 Agoda가 결정합니다.
아닙니다. 둘 다 Booking Holdings 계열이지만 플랫폼과 파트너 프로그램은 별개입니다. PHPTRAVELS는 Agoda와 연결되며 Booking.com 공식 커넥터는 없습니다.
네. Agoda는 Hotelbeds, Hotelston, RateHawk, Stuba, 자체 계약 호텔과 하나의 검색에서 함께 작동하며 각각 별도의 마크업 규칙을 적용합니다.
요금제와 활성화하는 공급업체 및 결제 흐름에 따라 다릅니다. 요금제는 일회성 라이선스 Startup $2499부터 시작합니다. 요금 페이지를 확인하거나 영업팀에 견적을 요청하세요.