Integra datos móviles en tu app.
Usa la API de eSIM para descubrir ofertas de datos, comprar paquetes y entregar enlaces de instalación privados desde tu aplicación. Mantén a los clientes en tu propia experiencia de cuenta para saldos reportados, recargas compatibles y compras recurrentes donde estén disponibles.
Empieza con las ofertas disponibles.
Usa una clave API del lado del servidor con permiso de lectura de eSIM para explorar el catálogo. Este ejemplo lista ofertas sin comprar un paquete.
bird esim offers listDe oferta a orden
Convierte una oferta en una compra recuperable.
Lee la cobertura, la asignación y la validez de la oferta, y luego obtén su precio de compra actual. La billetera de tu organización financia la compra. Guarda la orden resultante para que el cliente pueda volver a ella mientras Bird aprovisiona la eSIM y el paquete de datos.
Presenta los términos aceptados
Envía la revisión de la oferta aceptada y el precio con la orden. Si los términos cambian antes de la compra, muestra la cotización actualizada para su aceptación. Las compras recurrentes tienen sus propios términos y calendario disponibles.
Recupera sin otra compra
Guarda una clave de idempotencia antes de crear una orden y reutilízala con la misma solicitud si la respuesta se interrumpe. Si tienes el ID de la orden, lee esa orden primero para saber si se completó.
Instalación alojada
Envía la configuración que el cliente puede abrir.
Después de que la orden se complete, crea un enlace de instalación alojado o envíalo por correo electrónico o SMS. El cliente abre instrucciones específicas del dispositivo sin iniciar sesión en un espacio de trabajo de Bird. Rastrea la entrega del mensaje por separado de la instalación y la primera conexión de datos móviles.
Controla el acceso a la instalación
Las credenciales de instalación usan permisos API separados. Verifica la expiración del enlace alojado y revócalo si llega a la persona equivocada. Revocar un enlace detiene el acceso futuro a través de él; no desactiva un perfil ya instalado.
Lee los saldos de paquetes
Muestra la asignación comprada, la expiración y el consumo reportado con su hora de observación. Cuando el uso no esté disponible, déjalo como desconocido para que los clientes puedan distinguir la asignación de su paquete de un saldo restante medido.
Compras continuas
Permite que los clientes añadan datos a la misma eSIM.
Lista ofertas compatibles para una eSIM existente antes de presentar una recarga. Una recarga completada añade un paquete al perfil instalado, así el cliente puede seguir usando esa eSIM sin otra instalación.
Programa paquetes recurrentes
Cuando una oferta admite renovación, asigna a la persona que usa la eSIM y acepta su precio y cadencia recurrentes. Sigue el pago y la entrega del paquete en cada período, y permite que el cliente detenga la renovación futura.
Mantén el acceso del cliente en tu app
Autentica a tus clientes y autoriza el acceso a sus propias órdenes y eSIMs. Una clave API del espacio de trabajo puede acceder a recursos de varios clientes, así que mantenla en tu servidor y conecta cada recurso a la cuenta correcta.
Preguntas sobre la API de eSIM
¿Qué puedo construir con la API de eSIM?
¿Qué necesito para hacer una compra?
¿Cómo debo manejar una respuesta de compra interrumpida?
¿Una orden completada significa que el cliente está conectado?
Conecta el servicio completo
Escala sin
perder el control.
Organiza equipos en espacios de trabajo, controla el acceso a la API y rastrea cambios en los registros de auditoría.
Registro de auditoría
Producción- Espacio de trabajo
- Producción
- Recurso
- Agente de entrega
- Acceso de lecturaLectura y escritura