Integración de API eSIM
Integración de la API de Airalo: venda eSIM con cada viaje
Conecte su cuenta de socio de Airalo a PHPTRAVELS y venda eSIM locales, regionales y globales en su propia web, junto a vuelos, hoteles y tours. El conector está listo: añada su Client ID y su Client Secret, pruebe en sandbox, sincronice los paquetes, fije su precio y publique.
- Conector de Airalo listo
- Airalo Partner API v2
- Código QR y pasos de instalación
- Su propio precio de venta
El proveedor
Qué es Airalo y por qué las agencias venden sus eSIM
Airalo vende eSIM: paquetes de SIM digitales que el viajero instala en el teléfono sin retirar la SIM física. En lugar de comprar una SIM local en el aeropuerto, el viajero compra datos antes del viaje y los instala en pocos minutos.
Con la Partner API de Airalo, una empresa de viajes puede vender este inventario en su propia web o app. PHPTRAVELS incluye un conector de Airalo en el módulo eSIM, así que la eSIM es un producto más en el mismo carrito que el vuelo, el hotel, el traslado, el visado o el tour.
Relacionado:eSIMAPIs de viajesIntegración de API de viajes
- Empresa
- Airalo, proveedor de conectividad eSIM
- Cobertura
- Más de 200 destinos, según Airalo
- Paquetes
- eSIM locales, regionales y globales
- API
- Partner API v2 · REST · token Bearer
- SDK
- PHP · Node.js · Python
- En PHPTRAVELS
- Conector listo en el módulo eSIM
Paso 1 · Cuenta de socio
Solicite una cuenta de socio de Airalo
El acceso a la API de Airalo requiere un acuerdo de socio con Airalo. PHPTRAVELS no emite cuentas ni claves de Airalo: usted lo solicita, Airalo revisa su empresa y le envía sus credenciales.
Qué enviar a Airalo
- Nombre de la empresa y web
- País y tipo de negocio
- Volumen previsto de ventas de eSIM
- Mercados y destinos objetivo
- B2C, B2B o ambos
- Que utiliza PHPTRAVELS
Paso 2 · Credenciales
Client ID, Client Secret y el token de acceso
Cuando Airalo aprueba su cuenta, recibe un Client ID y un Client Secret. PHPTRAVELS los envía al endpoint de token desde su servidor, recibe un token de acceso Bearer y lo usa en cada solicitud de paquetes, pedidos y 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>
- Solo en el servidor
- El token lo solicita su servidor PHPTRAVELS. El Client Secret nunca llega al navegador.
- Reutilización del token
- El conector conserva el token hasta que caduca, así que no pide uno nuevo en cada búsqueda.
- Mantenga el secreto privado
- No ponga nunca el Client Secret en JavaScript público, HTML, un repositorio Git público, una captura de pantalla o un foro.
- Una cuenta, dos modos
- Airalo le permite elegir Sandbox o Production en su configuración. Pruebe todo primero en Sandbox.
El flujo de la Partner API
Cinco llamadas a la API de Airalo detrás de cada venta de eSIM
Desde el primer precio en pantalla hasta el código QR en el correo del viajero, el conector usa las mismas cinco llamadas. Cada una muestra qué hace PHPTRAVELS con la respuesta.
- 01Obtener un tokenPOST/v2/token
PHPTRAVELSInicia sesión con su Client ID y su Client Secret y guarda el token Bearer en el servidor.
- 02Listar paquetesGET/v2/packages
PHPTRAVELSSincroniza paquetes locales, regionales y globales con datos, validez, cobertura y precio neto, y aplica su precio.
- 03Enviar un pedidoPOST/v2/orders
PHPTRAVELSTras el pago, pide el ID de paquete y la cantidad elegidos y guarda el pedido de Airalo en la reserva.
- 04Leer la eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSLee la eSIM por su ICCID: código QR, código de activación, dirección SM-DP+ y enlace de instalación directa en iOS.
- 05Pasos de instalaciónGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSObtiene las instrucciones de instalación de Airalo para el dispositivo y el idioma del viajero y las añade al bono.
Pasos 3 a 5 · Administración de PHPTRAVELS
Configure, pruebe y sincronice Airalo en su panel
Todo se hace en los ajustes del módulo eSIM de su panel de PHPTRAVELS. Los campos exactos dependen de su versión de PHPTRAVELS.
- 01Active el módulo eSIMAbra los ajustes del módulo y active la integración eSIM de Airalo.
- 02Introduzca sus credencialesPegue el Client ID y el Client Secret de Airalo, elija Sandbox y guarde.
- 03Pruebe la conexiónUse el botón de prueba. PHPTRAVELS inicia sesión en Airalo y muestra el estado conectado o el error que debe corregir.
- 04Sincronice los paquetesCargue los paquetes de Airalo y compruebe que destinos, datos, validez y precios se ven bien en su web.
Entorno
Pedidos de prueba: no se emite ninguna eSIM realPedidos reales: eSIM reales, cargadas a su saldo de Airalo
Pantalla de ejemplo. Los campos pueden variar en su versión.
Paso 5 · Paquetes eSIM
eSIM locales, regionales y globales desde un solo feed
Airalo devuelve tres tipos de paquetes, para que adapte la eSIM al itinerario del viajero. Los paquetes, precios y disponibilidad llegan siempre en directo desde Airalo.
eSIM local
Un destino, para un viaje a un solo país.
EjemploeSIM de EE. UU.
eSIM regional
Varios países de una región, para un viaje por varios países.
EjemploeSIM de Europa
eSIM global
Países de varias regiones, para viajes largos o vueltas al mundo.
EjemploeSIM global
- Lo que ve el viajero
- Destino · nombre del paquete · datos · validez · red · cobertura · precio
- Tamaños de datos habituales: 1 GB, 3 GB, 5 GB y 10 GB, cada uno con su propia validez.
Pasos 6 a 9 · La venta
Cómo compra un viajero una eSIM de Airalo en su web
El viajero no sale nunca de su web. PHPTRAVELS gestiona la reserva y el pago, y Airalo emite la eSIM.
- 01Viajero
Abre la sección eSIM de su web
- 02Viajero
Elige un destino
- 03PHPTRAVELS
Muestra los paquetes de Airalo con su precio
- 04Viajero
Elige un paquete
- 05Viajero
Reserva y paga con su pasarela de pago
- 06PHPTRAVELS
Envía el pedido a la API de Airalo
- 07Airalo
Emite la eSIM
- 08Airalo
Devuelve el código QR y los datos de instalación
- 09PHPTRAVELS
Envía la eSIM al viajero por correo y en su cuenta
Entrega de la eSIM
Cinco formas de instalar la eSIM
Airalo ofrece varios flujos de instalación para socios de la API. PHPTRAVELS incluye los datos en el bono de reserva, el correo de confirmación y la cuenta del viajero.
Código QR
El viajero escanea el código QR desde los ajustes eSIM del teléfono.
Introducción manual
El código de activación y la dirección SM-DP+, para teléfonos que no pueden escanear.
Instrucciones de Airalo
Instrucciones de instalación paso a paso desde la API, por dispositivo e idioma.
Enlace eSIM Cloud o PDF
Un enlace para compartir o un PDF de Airalo con la guía de instalación completa.
Instalación directa en iOS
Un enlace de instalación con un toque para iPhone compatibles con versiones de iOS admitidas.
Datos del cliente
Asocie cada cliente a un ICCID
Airalo identifica cada eSIM por su ICCID y, en este flujo, no guarda los datos personales de sus viajeros. Mantener el vínculo entre el viajero y la eSIM es tarea suya, y PHPTRAVELS lo hace en la reserva.
- Cliente
- Reserva en PHPTRAVELS
- Pedido de Airalo
- ICCID
Esta cadena facilita el soporte:Solicitudes de soporteProblemas de instalaciónConsulta de pedidosHistorial de reservasEstado de la eSIM
Paso 7 · Su precio
Fije su precio de venta y gane con cada eSIM
Airalo le cobra el coste del paquete según su acuerdo comercial. Usted decide lo que paga el viajero, dentro de su acuerdo con Airalo.
Margen fijo
El mismo importe sobre cada paquete.
Margen porcentual
Un porcentaje del precio neto, así el margen crece con los planes más grandes.
Tarifa de servicio
Una tarifa aparte por pedido, visible en el pago.
Incluida en un paquete
Una eSIM incluida en un paquete vacacional o como regalo con un vuelo.
- Vuelo a Dubái
- Hotel en Dubái
- Traslado al aeropuerto
- eSIM de EAU
Por qué las agencias añaden eSIM
- Más ingresos por reserva
- Un servicio adicional que casi todo viajero internacional necesita
- Entrega digital inmediata, sin stock
- Los viajeros vuelven para el próximo viaje
La opción de vales. Airalo también vende vales eSIM: usted compra códigos de activación y los entrega a través de su web, app, CRM o correo. Elija el método que corresponda a su acuerdo con Airalo.
Solución de problemas
Si algo no funciona, revise esto primero
La mayoría de los problemas vienen de las credenciales, el entorno o el dispositivo. Recorra la lista del problema que observa.
- La prueba de conexión falla
- Client IDClient Secretcuenta de socio activaacceso a la API habilitadoSandbox o ProductionHTTPS saliente desde su servidorSSL
- No aparecen paquetes eSIM
- Conexión con la APIdisponibilidad de paquetesentornofiltros de destinorespuesta de la APIcaché de PHPTRAVELS
- Un pedido falla
- Paquete no válido o no disponiblesaldo de Airalofallo del tokenerror de redentorno incorrectoincidencia temporal de Airalo
- El código QR no aparece
- Pedido completadoeSIM emitidaICCID guardadodatos de instalación devueltoscampos QR en la respuesta de la API
- El viajero no puede instalarla
- El teléfono admite eSIMteléfono liberadoel código QR correctoeSIM no instalada yaroaming activadoAPN si es necesario
Quién hace qué
PHPTRAVELS gestiona el software, Airalo gestiona las eSIM
Airalo es un proveedor externo. La relación comercial es entre su empresa de viajes y Airalo.
PHPTRAVELS
- El conector de Airalo y sus ajustes
- Las páginas eSIM, la búsqueda y el pago
- Su margen y sus pasarelas de pago
- Bonos, correos y el ICCID en la reserva
- Soporte de la propia integración
Airalo
- Aprobación de socios y credenciales de la API
- Precios de paquetes, comisiones y reglas de saldo
- Cobertura, redes y disponibilidad de paquetes
- Disponibilidad de la API y emisión de eSIM
- Su acuerdo comercial
Seguridad
Proteja sus credenciales de Airalo
- Autentíquese solo desde el servidor, nunca en JavaScript del navegador
- Use HTTPS en su web y su panel
- Proteja el panel de administración y restrinja el acceso al servidor
- Mantenga PHPTRAVELS actualizado
- Vigile la actividad inusual en la API
Airalo
¿Necesita ayuda con la integración?
Si su cuenta de Airalo está aprobada pero la integración muestra un error, abra un ticket de soporte en su cuenta de PHPTRAVELS con: su versión de PHPTRAVELS, una captura de los ajustes de Airalo, el resultado de la prueba, un destino y un paquete de ejemplo, la referencia de la reserva y el mensaje de error. No incluya nunca el Client Secret completo.
Lea: cómo pueden vender eSIM online las agencias de viajesDocumentación para desarrolladores de Airalo
No. Necesita su propia cuenta de socio de Airalo aprobada. PHPTRAVELS proporciona el software y el conector de Airalo listo.
Airalo envía el Client ID y el Client Secret tras aprobar su cuenta de socio. PHPTRAVELS no los emite.
Los clientes de PHPTRAVELS pueden escribir a Rao Suhaib Khan, Head of Partnerships de Airalo, en rao.khan@airalo.com, e indicar que usan PHPTRAVELS.
Sí. Con una cuenta de socio de Airalo aprobada y el conector de PHPTRAVELS, los paquetes de Airalo admitidos aparecen en su propia web y la reserva se queda en su sitio.
Sí, un margen fijo o porcentual o una tarifa de servicio, siempre que encaje en su acuerdo comercial con Airalo.
Sí. Airalo tiene un modo Sandbox en el que los pedidos de prueba no emiten eSIM reales. Pase a Production solo cuando todo el flujo funcione.
Sí. Airalo ofrece paquetes locales, regionales y globales, según el inventario disponible para cada destino.
Con el código QR, introduciendo el código de activación y la dirección SM-DP+, con las instrucciones paso a paso de Airalo, desde un enlace eSIM Cloud o un PDF, o con un enlace de instalación directa en iPhone compatibles.
No. Airalo tiene SDK para PHP, Node.js y Python, pero el conector ya está en PHPTRAVELS. Solo tiene que añadir sus credenciales.
Sigue explorando
Más sobre la plataforma
- eSIM
- Integración API de TiqetsEntradas de atracciones de Tiqets en tu motor de reservas
- Integración de la API de ViatorTours y actividades de Viator en tu sitio de reservas
- Integración de PKFARE APIBúsqueda, reserva y PNR de PKFARE en tu portal
- Integración de la API de RateHawkHoteles de RateHawk en tu motor de reservas, conector listo
- APIs de viajesAPIs de GDS, hoteles, tours, coches y pagos