Demo trực tiếp

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

Thông tin nhà cung cấp
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.

Yêu cầu token (mẫu)
 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>
client_credentialsPartner API v2Bearer token · Sandbox → Production
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.

  1. 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ủ.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  1. 01Bật module eSIMMở phần cài đặt module và bật tích hợp Airalo eSIM.
  2. 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.
  3. 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.
  4. 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.
Module eSIM · AiraloAiralo

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

Client ID7f3c…a91e
Client Secret••••••••••••••••
Markup15% trên giá net
Trạng tháiĐã kết nối

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.

  1. 01Khách du lịch

    Mở mục eSIM trên website của bạn

  2. 02Khách du lịch

    Chọn điểm đến

  3. 03PHPTRAVELS

    Hiển thị các gói Airalo theo giá bán của bạn

  4. 04Khách du lịch

    Chọn một gói

  5. 05Khách du lịch

    Đặt và thanh toán qua cổng thanh toán của bạn

  6. 06PHPTRAVELS

    Gửi đơn hàng đến Airalo API

  7. 07Airalo

    Cấp eSIM

  8. 08Airalo

    Trả về mã QR và thông tin cài đặt

  9. 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.

  1. Khách hàng
  2. Booking PHPTRAVELS
  3. Đơn hàng Airalo
  4. 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.

Ví dụ bán chéo
  1. Chuyến bay đến Dubai
  2. Khách sạn ở Dubai
  3. Đưa đón sân bay
  4. 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

Câu hỏi thường gặp

Tích hợp Airalo API: những câu hỏi đại lý thường đặt ra

Liên hệ kinh doanh

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.