eSIM API 연동
Airalo API 연동: 모든 여행에 eSIM을 함께
Airalo 파트너 계정을 PHPTRAVELS에 연결하고 로컬, 지역, 글로벌 eSIM을 자사 웹사이트에서 항공권, 호텔, 투어와 함께 판매하십시오. 커넥터는 이미 준비되어 있습니다. Client ID와 Client Secret을 입력하고 Sandbox에서 테스트한 뒤, 패키지를 동기화하고 가격을 정하면 바로 오픈할 수 있습니다.
- 기본 제공 Airalo 커넥터
- Airalo Partner API v2
- QR 코드와 설치 안내
- 자체 판매 가격
공급사
Airalo란 무엇이며, 여행사가 Airalo eSIM을 판매하는 이유
Airalo는 eSIM을 판매합니다. eSIM은 물리 SIM을 빼지 않고 휴대폰에 설치하는 디지털 SIM 패키지입니다. 여행자는 공항에서 현지 SIM을 사는 대신 출발 전에 데이터를 구매하고 몇 분 만에 설치합니다.
Airalo Partner API를 통해 여행 사업자는 이 상품을 자사 웹사이트나 앱에서 판매할 수 있습니다. PHPTRAVELS는 eSIM 모듈에 Airalo 커넥터를 기본 제공합니다. 따라서 eSIM은 항공권, 호텔, 픽업, 비자, 투어와 같은 장바구니에 담기는 또 하나의 상품이 됩니다.
- 회사
- Airalo, eSIM 통신 서비스 제공업체
- 지원 지역
- 200개 이상의 국가 및 지역(Airalo 발표 기준)
- 패키지
- 로컬, 지역, 글로벌 eSIM
- API
- Partner API v2 · REST · Bearer 토큰
- SDK
- PHP · Node.js · Python
- PHPTRAVELS에서는
- eSIM 모듈에 커넥터 기본 제공
1단계 · 파트너 계정
Airalo 파트너 계정 신청하기
Airalo API를 사용하려면 Airalo와 파트너 계약을 맺어야 합니다. PHPTRAVELS는 Airalo 계정이나 키를 발급하지 않습니다. 고객이 직접 신청하면 Airalo가 사업 내용을 검토한 후 인증 정보를 보내 드립니다.
Airalo에 보낼 정보
- 회사명과 웹사이트
- 국가와 사업 유형
- 예상 eSIM 판매량
- 목표 시장과 여행지
- B2C, B2B 또는 둘 다
- PHPTRAVELS를 사용한다는 사실
2단계 · 인증 정보
Client ID, Client Secret, 액세스 토큰
Airalo가 계정을 승인하면 Client ID와 Client Secret을 받게 됩니다. PHPTRAVELS는 서버에서 이를 토큰 엔드포인트로 전송하고 Bearer 액세스 토큰을 받습니다. 이 토큰은 모든 패키지, 주문, eSIM 요청에 사용됩니다.
1# Server-side only: the Client Secret never reaches the browser 2curl -X POST "$AIRALO_API/v2/token" \ 3 -H "Accept: application/json" \ 4 -F "client_id=$CLIENT_ID" \ 5 -F "client_secret=$CLIENT_SECRET" \ 6 -F "grant_type=client_credentials" 7 8# → { "data": { "access_token": "eyJ0eXAi…", "expires_in": … } } 9# then: Authorization: Bearer <access_token>
- 서버에서만 처리
- 토큰은 PHPTRAVELS 서버가 요청합니다. Client Secret은 브라우저로 전달되지 않습니다.
- 토큰 재사용
- 커넥터는 토큰이 만료될 때까지 보관합니다. 검색할 때마다 새 토큰을 요청하지 않습니다.
- Secret을 비공개로 유지
- Client Secret을 공개 JavaScript, HTML, 공개 Git 저장소, 스크린샷, 포럼 게시물에 절대 넣지 마십시오.
- 하나의 계정, 두 가지 모드
- Airalo 설정에서 Sandbox 또는 Production을 선택할 수 있습니다. 먼저 Sandbox에서 모든 것을 테스트하십시오.
Partner API 흐름
모든 eSIM 판매를 처리하는 5가지 Airalo API 호출
화면에 첫 가격이 표시될 때부터 여행자의 메일함에 QR 코드가 도착할 때까지, 커넥터는 동일한 5가지 호출을 사용합니다. 각 호출마다 PHPTRAVELS가 응답을 어떻게 처리하는지 보여 드립니다.
- 01토큰 받기POST/v2/token
PHPTRAVELSClient ID와 Client Secret으로 로그인하고 Bearer 토큰을 서버에 저장합니다.
- 02패키지 목록 조회GET/v2/packages
PHPTRAVELS로컬, 지역, 글로벌 패키지를 데이터, 유효 기간, 지원 지역, 공급가와 함께 동기화한 후 고객님의 가격을 적용합니다.
- 03주문 제출POST/v2/orders
PHPTRAVELS결제 후 선택한 패키지 ID와 수량으로 주문하고 Airalo 주문 정보를 예약에 저장합니다.
- 04eSIM 조회GET/v2/sims/{sim_iccid}
PHPTRAVELSICCID로 eSIM을 조회합니다. QR 코드, 활성화 코드, SM-DP+ 주소, iOS 바로 설치 링크를 가져옵니다.
- 05설치 안내GET/v2/sims/{sim_iccid}/instructions
PHPTRAVELS여행자의 기기와 언어에 맞는 Airalo 설치 안내를 받아 바우처에 추가합니다.
3~5단계 · PHPTRAVELS 관리자
관리자 화면에서 Airalo 설정, 테스트, 동기화하기
모든 작업은 PHPTRAVELS 관리자의 eSIM 모듈 설정에서 진행합니다. 정확한 항목은 PHPTRAVELS 버전에 따라 다릅니다.
- 01eSIM 모듈 활성화모듈 설정을 열고 Airalo eSIM 연동을 켜십시오.
- 02인증 정보 입력Airalo에서 받은 Client ID와 Client Secret을 붙여 넣고 Sandbox를 선택한 뒤 저장하십시오.
- 03연결 테스트테스트 버튼을 누르십시오. PHPTRAVELS가 Airalo에 로그인하여 연결됨 상태 또는 수정할 오류를 표시합니다.
- 04패키지 동기화Airalo 패키지를 불러온 뒤 여행지, 데이터, 유효 기간, 가격이 웹사이트에 올바르게 표시되는지 확인하십시오.
환경
테스트 주문: 실제 eSIM이 발급되지 않습니다실제 주문: 실제 eSIM이 발급되며 Airalo 잔액에서 차감됩니다
샘플 화면입니다. 버전에 따라 항목이 다를 수 있습니다.
5단계 · eSIM 패키지
로컬, 지역, 글로벌 eSIM을 하나의 피드로
Airalo는 세 가지 유형의 패키지를 제공하므로 여행자의 일정에 맞는 eSIM을 고를 수 있습니다. 패키지, 가격, 재고는 항상 Airalo에서 실시간으로 가져옵니다.
로컬 eSIM
한 곳의 여행지용. 한 나라만 방문하는 여행에 적합합니다.
예시미국 eSIM
지역 eSIM
한 지역 내 여러 국가 지원. 여러 나라를 도는 여행에 적합합니다.
예시유럽 eSIM
글로벌 eSIM
여러 지역의 국가 지원. 장기 여행이나 세계 일주에 적합합니다.
예시글로벌 eSIM
- 여행자에게 표시되는 정보
- 여행지 · 패키지명 · 데이터 · 유효 기간 · 통신망 · 지원 지역 · 가격
- 일반적인 데이터 용량: 1 GB, 3 GB, 5 GB, 10 GB이며, 각각 유효 기간이 정해져 있습니다.
6~9단계 · 판매
여행자가 웹사이트에서 Airalo eSIM을 구매하는 과정
여행자는 사이트를 떠나지 않습니다. 예약과 결제는 PHPTRAVELS가, eSIM 발급은 Airalo가 담당합니다.
- 01여행자
웹사이트의 eSIM 페이지를 엽니다
- 02여행자
여행지를 선택합니다
- 03PHPTRAVELS
고객님의 가격으로 Airalo 패키지를 표시합니다
- 04여행자
패키지를 고릅니다
- 05여행자
고객님의 결제 게이트웨이로 예약하고 결제합니다
- 06PHPTRAVELS
주문을 Airalo API로 전송합니다
- 07Airalo
eSIM을 발급합니다
- 08Airalo
QR 코드와 설치 정보를 반환합니다
- 09PHPTRAVELS
eSIM을 이메일과 계정을 통해 여행자에게 전달합니다
eSIM 전달
여행자가 eSIM을 설치하는 5가지 방법
Airalo는 API 파트너를 위해 여러 설치 방식을 지원합니다. PHPTRAVELS는 이 정보를 예약 바우처, 확인 이메일, 여행자 계정에 표시합니다.
QR 코드
여행자는 휴대폰의 eSIM 설정에서 QR 코드를 스캔합니다.
수동 입력
스캔할 수 없는 휴대폰을 위한 활성화 코드와 SM-DP+ 주소입니다.
Airalo 설치 안내
API에서 제공하는 기기별, 언어별 단계별 설치 안내입니다.
eSIM Cloud 링크 또는 PDF
전체 설치 가이드가 담긴 Airalo의 공유 링크 또는 PDF입니다.
iOS 바로 설치
지원되는 iOS 버전의 호환 iPhone에서 한 번의 탭으로 설치하는 링크입니다.
고객 데이터
모든 고객을 ICCID와 연결하기
Airalo는 각 eSIM을 ICCID로 식별하며, 이 방식에서는 여행자의 개인 데이터를 저장하지 않습니다. 여행자와 eSIM의 연결 관리는 고객님의 몫이며, PHPTRAVELS가 이를 예약에서 처리합니다.
- 고객
- PHPTRAVELS 예약
- Airalo 주문
- ICCID
이 연결 덕분에 고객 지원이 쉬워집니다:지원 요청설치 문제주문 조회예약 내역eSIM 상태
7단계 · 판매 가격
판매 가격을 정하고 eSIM마다 수익 올리기
Airalo는 상업 계약에 따른 패키지 비용을 고객님께 청구합니다. 여행자가 지불할 금액은 Airalo와의 계약 범위 안에서 고객님이 결정합니다.
고정 마크업
모든 패키지에 같은 금액을 더합니다.
비율 마크업
공급가의 일정 비율을 더하므로 큰 요금제일수록 마진이 커집니다.
서비스 수수료
주문마다 별도의 수수료를 받고 결제 화면에 표시합니다.
패키지에 포함
여행 패키지에 eSIM을 포함하거나 항공권 구매 시 선물로 제공합니다.
- 두바이행 항공권
- 두바이 호텔
- 공항 픽업
- UAE eSIM
여행사가 eSIM을 추가하는 이유
- 예약당 매출 증가
- 거의 모든 해외 여행자에게 필요한 부가 상품
- 즉시 디지털 전달, 재고 불필요
- 다음 여행 때도 다시 찾는 여행자
바우처 방식. Airalo는 eSIM 바우처도 판매합니다. 활성화 코드를 구매해 웹사이트, 앱, CRM, 이메일로 배포할 수 있습니다. Airalo와의 계약에 맞는 방식을 선택하십시오.
문제 해결
문제가 생기면 먼저 이 항목을 확인하십시오
대부분의 문제는 인증 정보, 환경, 기기 중 하나에서 비롯됩니다. 발생한 문제에 해당하는 목록을 위에서부터 차례로 확인하십시오.
- 연결 테스트가 실패합니다
- Client IDClient Secret파트너 계정 활성 상태API 접근 허용 여부Sandbox 또는 Production서버의 외부 HTTPS 연결SSL
- eSIM 패키지가 표시되지 않습니다
- API 연결패키지 재고환경여행지 필터API 응답PHPTRAVELS 캐시
- 주문이 실패합니다
- 유효하지 않거나 판매 불가한 패키지Airalo 잔액토큰 오류네트워크 오류잘못된 환경Airalo 측 일시적 문제
- QR 코드가 표시되지 않습니다
- 주문 완료 여부eSIM 발급 여부ICCID 저장 여부설치 정보 반환 여부API 응답의 QR 항목
- 여행자가 설치하지 못합니다
- 휴대폰의 eSIM 지원 여부잠금 해제된 휴대폰올바른 QR 코드eSIM 미설치 상태로밍 켜짐필요 시 APN
역할 분담
소프트웨어는 PHPTRAVELS, eSIM은 Airalo
Airalo는 외부 공급사입니다. 상업적 관계는 고객님의 여행 사업과 Airalo 사이에 성립합니다.
PHPTRAVELS
- Airalo 커넥터와 설정
- eSIM 페이지, 검색, 결제
- 마크업과 결제 게이트웨이
- 바우처, 이메일, 예약의 ICCID
- 연동 자체에 대한 지원
Airalo
- 파트너 승인과 API 인증 정보
- 패키지 가격, 수수료, 잔액 규정
- 지원 지역, 통신망, 패키지 재고
- API 가동과 eSIM 발급
- 고객님의 상업 계약
보안
Airalo 인증 정보 보호하기
- 인증은 서버에서만 하고, 브라우저 JavaScript에서는 절대 하지 마십시오
- 웹사이트와 관리자 화면에 HTTPS를 사용하십시오
- 관리자 패널을 보호하고 서버 접근을 제한하십시오
- PHPTRAVELS를 최신 상태로 유지하십시오
- 비정상적인 API 활동을 모니터링하십시오
Airalo
연동에 도움이 필요하십니까?
Airalo 계정은 승인되었는데 연동에서 오류가 표시된다면, PHPTRAVELS 계정에서 지원 티켓을 열어 주십시오. PHPTRAVELS 버전, Airalo 설정 화면 스크린샷, 테스트 결과, 예시 여행지와 패키지, 예약 번호, 오류 메시지를 함께 보내 주십시오. Client Secret 전체는 절대 포함하지 마십시오.
아닙니다. 승인된 Airalo 파트너 계정을 직접 보유하셔야 합니다. PHPTRAVELS는 소프트웨어와 기본 제공 Airalo 커넥터를 제공합니다.
Airalo가 파트너 계정을 승인한 후 Client ID와 Client Secret을 보내 드립니다. PHPTRAVELS는 이를 발급하지 않습니다.
PHPTRAVELS 고객은 Airalo 파트너십 총괄 Rao Suhaib Khan에게 rao.khan@airalo.com으로 이메일을 보내고 PHPTRAVELS를 사용한다고 알려 주시면 됩니다.
네. 승인된 Airalo 파트너 계정과 PHPTRAVELS 커넥터가 있으면 지원되는 Airalo 패키지가 자사 웹사이트에 표시되고 예약도 사이트 안에서 완료됩니다.
네. Airalo와의 상업 계약에 맞는 범위에서 고정 또는 비율 마크업이나 서비스 수수료를 설정할 수 있습니다.
네. Airalo에는 Sandbox 모드가 있으며, 테스트 주문으로는 실제 eSIM이 발급되지 않습니다. 전체 흐름이 정상 작동한 후에 Production으로 전환하십시오.
네. Airalo는 여행지별 재고에 따라 로컬, 지역, 글로벌 패키지를 제공합니다.
QR 코드, 활성화 코드와 SM-DP+ 주소 입력, Airalo의 단계별 안내, eSIM Cloud 링크 또는 PDF, 호환 iPhone의 바로 설치 링크 중 하나를 사용합니다.
아닙니다. Airalo는 PHP, Node.js, Python용 SDK를 제공하지만, 커넥터는 이미 PHPTRAVELS에 포함되어 있습니다. 인증 정보만 추가하시면 됩니다.
