Tích hợp eSIM API
Tích hợp Airalo API: bán eSIM cùng mọi chuyến đi
Kết nối tài khoản đối tác Airalo với PHPTRAVELS và bán eSIM nội địa, khu vực và toàn cầu ngay trên website của bạn, bên cạnh vé máy bay, khách sạn và tour. Connector đã sẵn sàng: nhập Client ID và Client Secret, thử nghiệm trong sandbox, đồng bộ các gói, đặt giá và đưa vào hoạt động.
- Connector Airalo có sẵn
- Airalo Partner API v2
- Mã QR và các bước cài đặt
- Giá bán do bạn quyết định
Nhà cung cấp
Airalo là gì và vì sao các đại lý du lịch bán eSIM của Airalo
Airalo bán eSIM: gói SIM kỹ thuật số mà khách du lịch cài lên điện thoại mà không cần tháo SIM vật lý. Thay vì mua SIM địa phương tại sân bay, khách mua gói dữ liệu trước chuyến đi và cài đặt trong vài phút.
Thông qua Airalo Partner API, doanh nghiệp du lịch có thể bán sản phẩm này ngay trên website hoặc ứng dụng của mình. PHPTRAVELS tích hợp sẵn connector Airalo trong module eSIM, nên eSIM trở thành một sản phẩm nữa trong cùng giỏ hàng với vé máy bay, khách sạn, đưa đón, visa hoặc tour.
Liên quan:eSIMAPI du lịchTích hợp API du lịch
- Công ty
- Airalo, nhà cung cấp kết nối eSIM
- Phạm vi phủ sóng
- Hơn 200 điểm đến, theo Airalo công bố
- Gói cước
- eSIM nội địa, khu vực và toàn cầu
- API
- Partner API v2 · REST · Bearer token
- SDK
- PHP · Node.js · Python
- Trong PHPTRAVELS
- Connector có sẵn trong module eSIM
Bước 1 · Tài khoản đối tác
Đăng ký tài khoản đối tác Airalo
Để dùng Airalo API, bạn cần có thỏa thuận đối tác với Airalo. PHPTRAVELS không cấp tài khoản hay khóa Airalo: bạn gửi đơn đăng ký, Airalo xem xét doanh nghiệp của bạn và gửi thông tin xác thực.
Thông tin cần gửi Airalo
- Tên công ty và website
- Quốc gia và loại hình kinh doanh
- Doanh số eSIM dự kiến
- Thị trường và điểm đến mục tiêu
- B2C, B2B hoặc cả hai
- Cho biết bạn dùng PHPTRAVELS
Bước 2 · Thông tin xác thực
Client ID, Client Secret và access token
Khi Airalo duyệt tài khoản, bạn sẽ nhận được Client ID và Client Secret. PHPTRAVELS gửi chúng từ máy chủ của bạn đến token endpoint, nhận Bearer access token và dùng token này cho mọi yêu cầu về gói, đơn hàng và 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>
- Chỉ phía máy chủ
- Token do máy chủ PHPTRAVELS của bạn yêu cầu. Client Secret không bao giờ được gửi đến trình duyệt.
- Tái sử dụng token
- Connector giữ token cho đến khi hết hạn, nên không phải xin token mới cho mỗi lần tìm kiếm.
- Giữ bí mật Secret
- Không bao giờ đặt Client Secret trong JavaScript, HTML công khai, kho Git công khai, ảnh chụp màn hình hay bài đăng diễn đàn.
- Một tài khoản, hai chế độ
- Airalo cho phép bạn chọn Sandbox hoặc Production trong phần cấu hình. Hãy thử nghiệm mọi thứ trong Sandbox trước.
Quy trình Partner API
Năm lệnh gọi Airalo API đằng sau mỗi lượt bán eSIM
Từ mức giá đầu tiên hiển thị trên màn hình đến mã QR trong hộp thư của khách, connector luôn dùng năm lệnh gọi này. Mỗi mục cho thấy PHPTRAVELS xử lý kết quả trả về như thế nào.
- 01Lấy tokenPOST/v2/token
PHPTRAVELSĐăng nhập bằng Client ID và Client Secret của bạn, sau đó lưu Bearer token trên máy chủ.
- 02Lấy danh sách góiGET/v2/packages
PHPTRAVELSĐồng bộ các gói nội địa, khu vực và toàn cầu kèm dung lượng, thời hạn, phạm vi phủ sóng và giá net, rồi áp dụng giá bán của bạn.
- 03Gửi đơn hàngPOST/v2/orders
PHPTRAVELSSau khi thanh toán, đặt mua theo package ID và số lượng đã chọn, rồi lưu đơn Airalo vào booking.
- 04Đọc thông tin eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSĐọc eSIM theo ICCID: mã QR, mã kích hoạt, địa chỉ SM-DP+ và liên kết cài đặt trực tiếp cho iOS.
- 05Các bước cài đặtGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSLấy hướng dẫn cài đặt của Airalo theo thiết bị và ngôn ngữ của khách, rồi thêm vào voucher.
Bước 3 đến 5 · Trang quản trị PHPTRAVELS
Cấu hình, thử nghiệm và đồng bộ Airalo trong trang quản trị
Mọi thao tác đều thực hiện trong phần cài đặt module eSIM của trang quản trị PHPTRAVELS. Các trường cụ thể tùy thuộc vào phiên bản PHPTRAVELS của bạn.
- 01Bật module eSIMMở phần cài đặt module và bật tích hợp Airalo eSIM.
- 02Nhập thông tin xác thựcDán Client ID và Client Secret từ Airalo, chọn Sandbox và lưu lại.
- 03Kiểm tra kết nốiNhấn nút Kiểm tra. PHPTRAVELS đăng nhập vào Airalo và hiển thị trạng thái đã kết nối, hoặc lỗi cần khắc phục.
- 04Đồng bộ các góiTải các gói Airalo và kiểm tra điểm đến, dung lượng, thời hạn và giá hiển thị đúng trên website của bạn.
Môi trường
Đơn thử nghiệm: không cấp eSIM thậtĐơn thật: eSIM thật, trừ vào số dư Airalo của bạn
Màn hình mẫu. Các trường có thể khác trong phiên bản của bạn.
Bước 5 · Gói eSIM
eSIM nội địa, khu vực và toàn cầu từ một nguồn dữ liệu
Airalo cung cấp ba loại gói, giúp bạn chọn eSIM phù hợp với lịch trình của khách. Gói, giá và tình trạng còn hàng luôn được cập nhật trực tiếp từ Airalo.
eSIM nội địa
Một điểm đến, cho chuyến đi đến một quốc gia.
Ví dụeSIM Mỹ
eSIM khu vực
Nhiều quốc gia trong một khu vực, cho chuyến đi nhiều nước.
Ví dụeSIM châu Âu
eSIM toàn cầu
Các quốc gia thuộc nhiều khu vực, cho chuyến đi dài ngày hoặc vòng quanh thế giới.
Ví dụeSIM toàn cầu
- Thông tin hiển thị cho khách
- Điểm đến · tên gói · dung lượng · thời hạn · nhà mạng · phạm vi phủ sóng · giá
- Dung lượng phổ biến: 1 GB, 3 GB, 5 GB và 10 GB, mỗi gói có thời hạn riêng.
Bước 6 đến 9 · Quy trình bán
Khách du lịch mua eSIM Airalo trên website của bạn như thế nào
Khách không bao giờ phải rời khỏi website của bạn. PHPTRAVELS xử lý đặt chỗ và thanh toán, Airalo cấp eSIM.
- 01Khách du lịch
Mở mục eSIM trên website của bạn
- 02Khách du lịch
Chọn điểm đến
- 03PHPTRAVELS
Hiển thị các gói Airalo theo giá bán của bạn
- 04Khách du lịch
Chọn một gói
- 05Khách du lịch
Đặt và thanh toán qua cổng thanh toán của bạn
- 06PHPTRAVELS
Gửi đơn hàng đến Airalo API
- 07Airalo
Cấp eSIM
- 08Airalo
Trả về mã QR và thông tin cài đặt
- 09PHPTRAVELS
Gửi eSIM cho khách qua email và trong tài khoản
Giao eSIM
Năm cách khách du lịch có thể cài đặt eSIM
Airalo hỗ trợ nhiều quy trình cài đặt cho đối tác API. PHPTRAVELS đưa thông tin vào voucher đặt chỗ, email xác nhận và tài khoản của khách.
Mã QR
Khách quét mã QR trong phần cài đặt eSIM của điện thoại.
Nhập thủ công
Mã kích hoạt và địa chỉ SM-DP+, dành cho điện thoại không quét được mã.
Hướng dẫn của Airalo
Hướng dẫn cài đặt từng bước từ API, theo thiết bị và ngôn ngữ.
Liên kết eSIM Cloud hoặc PDF
Liên kết chia sẻ hoặc tệp PDF từ Airalo với hướng dẫn cài đặt đầy đủ.
Cài đặt trực tiếp trên iOS
Liên kết cài đặt một chạm cho iPhone tương thích chạy phiên bản iOS được hỗ trợ.
Dữ liệu khách hàng
Liên kết mỗi khách hàng với một ICCID
Airalo nhận diện mỗi eSIM bằng ICCID và, trong quy trình này, không lưu dữ liệu cá nhân của khách. Việc lưu liên kết giữa khách và eSIM là trách nhiệm của bạn, và PHPTRAVELS thực hiện điều đó ngay trên booking.
- Khách hàng
- Booking PHPTRAVELS
- Đơn hàng Airalo
- ICCID
Chuỗi liên kết này giúp việc hỗ trợ dễ dàng hơn:Yêu cầu hỗ trợSự cố cài đặtTra cứu đơn hàngLịch sử đặt chỗTrạng thái eSIM
Bước 7 · Giá của bạn
Đặt giá bán và có lợi nhuận từ mỗi eSIM
Airalo tính cho bạn chi phí gói theo thỏa thuận thương mại. Bạn quyết định khách trả bao nhiêu, trong phạm vi thỏa thuận với Airalo.
Markup cố định
Cộng cùng một khoản tiền vào mọi gói.
Markup theo phần trăm
Một tỷ lệ phần trăm trên giá net, nên lợi nhuận tăng theo gói lớn hơn.
Phí dịch vụ
Một khoản phí riêng cho mỗi đơn hàng, hiển thị khi thanh toán.
Bao gồm trong gói
eSIM được bao gồm trong gói kỳ nghỉ hoặc tặng kèm vé máy bay.
- Chuyến bay đến Dubai
- Khách sạn ở Dubai
- Đưa đón sân bay
- eSIM UAE
Vì sao các đại lý bổ sung eSIM
- Tăng doanh thu trên mỗi booking
- Dịch vụ bổ trợ mà hầu hết khách quốc tế đều cần
- Giao hàng kỹ thuật số tức thì, không cần tồn kho
- Khách quay lại cho chuyến đi tiếp theo
Phương án voucher. Airalo cũng bán voucher eSIM: bạn mua mã kích hoạt và phân phối qua website, ứng dụng, CRM hoặc email. Hãy chọn phương thức phù hợp với thỏa thuận Airalo của bạn.
Khắc phục sự cố
Khi có gì đó không hoạt động, hãy kiểm tra những mục này trước
Hầu hết sự cố đến từ thông tin xác thực, môi trường hoặc thiết bị. Hãy kiểm tra lần lượt danh sách tương ứng với sự cố bạn gặp.
- Kiểm tra kết nối thất bại
- Client IDClient Secrettài khoản đối tác đang hoạt độngđã bật quyền APISandbox hay ProductionHTTPS gửi đi từ máy chủSSL
- Không hiển thị gói eSIM nào
- Kết nối APItình trạng góimôi trườngbộ lọc điểm đếnphản hồi của APIbộ nhớ đệm PHPTRAVELS
- Đơn hàng thất bại
- Gói không hợp lệ hoặc không khả dụngsố dư Airalolỗi tokenlỗi mạngsai môi trườngsự cố tạm thời của Airalo
- Mã QR không hiển thị
- Đơn hàng đã hoàn tấteSIM đã được cấpđã lưu ICCIDđã trả về dữ liệu cài đặtcác trường QR trong phản hồi API
- Khách không cài đặt được
- Điện thoại hỗ trợ eSIMđiện thoại không khóa mạngđúng mã QReSIM chưa được càiđã bật chuyển vùngAPN nếu cần
Ai làm gì
PHPTRAVELS vận hành phần mềm, Airalo vận hành eSIM
Airalo là nhà cung cấp bên ngoài. Quan hệ thương mại là giữa doanh nghiệp du lịch của bạn và Airalo.
PHPTRAVELS
- Connector Airalo và phần cài đặt
- Trang eSIM, tìm kiếm và thanh toán
- Markup và cổng thanh toán của bạn
- Voucher, email và ICCID trên booking
- Hỗ trợ cho chính phần tích hợp
Airalo
- Duyệt đối tác và thông tin xác thực API
- Giá gói, hoa hồng và quy định số dư
- Phạm vi phủ sóng, nhà mạng và tình trạng gói
- Thời gian hoạt động của API và việc cấp eSIM
- Thỏa thuận thương mại của bạn
Bảo mật
Bảo vệ thông tin xác thực Airalo của bạn
- Chỉ xác thực từ máy chủ, không bao giờ trong JavaScript của trình duyệt
- Dùng HTTPS cho website và trang quản trị
- Bảo mật trang quản trị và giới hạn quyền truy cập máy chủ
- Luôn cập nhật PHPTRAVELS
- Theo dõi hoạt động API bất thường
Airalo
Cần hỗ trợ về tích hợp?
Nếu tài khoản Airalo của bạn đã được duyệt nhưng phần tích hợp báo lỗi, hãy mở phiếu hỗ trợ trong tài khoản PHPTRAVELS kèm theo: phiên bản PHPTRAVELS, ảnh chụp phần cài đặt Airalo, kết quả kiểm tra, một điểm đến và gói mẫu, mã booking và thông báo lỗi. Không bao giờ gửi kèm toàn bộ Client Secret.
Đọc: các đại lý du lịch bán eSIM trực tuyến như thế nàoTài liệu dành cho nhà phát triển của Airalo
Không. Bạn cần có tài khoản đối tác Airalo riêng đã được duyệt. PHPTRAVELS cung cấp phần mềm và connector Airalo có sẵn.
Airalo gửi Client ID và Client Secret sau khi duyệt tài khoản đối tác của bạn. PHPTRAVELS không cấp các thông tin này.
Khách hàng PHPTRAVELS có thể gửi email cho Rao Suhaib Khan, Trưởng bộ phận Đối tác tại Airalo, theo địa chỉ rao.khan@airalo.com và cho biết bạn dùng PHPTRAVELS.
Có. Với tài khoản đối tác Airalo đã được duyệt và connector PHPTRAVELS, các gói Airalo được hỗ trợ sẽ hiển thị trên website của bạn và việc đặt chỗ diễn ra ngay trên website của bạn.
Có, markup cố định, markup theo phần trăm hoặc phí dịch vụ, miễn là phù hợp với thỏa thuận thương mại của bạn với Airalo.
Có. Airalo có chế độ Sandbox, trong đó đơn thử nghiệm không cấp eSIM thật. Chỉ chuyển sang Production khi toàn bộ quy trình đã hoạt động.
Có. Airalo cung cấp các gói nội địa, khu vực và toàn cầu, tùy theo nguồn hàng có sẵn cho từng điểm đến.
Bằng mã QR, nhập mã kích hoạt và địa chỉ SM-DP+, làm theo hướng dẫn từng bước của Airalo, dùng liên kết eSIM Cloud hoặc PDF, hoặc dùng liên kết cài đặt trực tiếp trên iPhone tương thích.
Không. Airalo có SDK cho PHP, Node.js và Python, nhưng connector đã có sẵn trong PHPTRAVELS. Bạn chỉ cần nhập thông tin xác thực.
Khám phá thêm
Thêm về nền tảng
- eSIM
- Tích hợp API TiqetsVé điểm tham quan Tiqets trong hệ thống đặt chỗ của bạn
- Tích hợp API ViatorTour và hoạt động Viator trên trang đặt chỗ của bạn
- Tích hợp PKFARE APITìm kiếm, đặt vé và PNR PKFARE trên cổng của bạn
- Tích hợp API RateHawkKhách sạn RateHawk trong hệ thống đặt phòng, connector có sẵn
- API du lịchAPI GDS, khách sạn, tour, xe và thanh toán
