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.

1
bird esim offers list

De 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?
Integra en tu app el descubrimiento de ofertas, la compra de paquetes de datos, la entrega de instalación y la gestión continua de paquetes. Los clientes pueden comprar recargas compatibles e inscribirse en compras recurrentes donde estén disponibles. Tu aplicación gestiona la autenticación del cliente y cualquier pago que recaude.
¿Qué necesito para hacer una compra?
Usa un espacio de trabajo de Bird, una clave API del lado del servidor con los permisos de eSIM necesarios y fondos en la billetera de la organización. Revisa la oferta, los términos de compra y los requisitos de identificación antes de comprar. Leer credenciales y crear o enviar enlaces de instalación requiere permisos de credenciales separados.
¿Cómo debo manejar una respuesta de compra interrumpida?
Lee la orden existente si tienes su ID. De lo contrario, repite la solicitud de creación guardada con su clave de idempotencia original. Sigue esa orden hasta su finalización o fallo antes de crear un reemplazo que pueda generar otro cargo.
¿Una orden completada significa que el cliente está conectado?
Una orden completada identifica la eSIM y el paquete comprados. El cliente aún necesita instalar el perfil en un dispositivo compatible y probar los datos móviles en un destino con cobertura. Los informes de instalación y saldo pueden llegar después del resultado del dispositivo.

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.

BirdHarborOrganización
Espacios de trabajoProducciónSandbox

Agente de entrega

Clave de API · Equipo de Operaciones de clientes
Activo
PermisosAcceso
EmailLectura y escritura
SMSLectura y escritura
ALAlex Lee AdministradorPermisos actualizados

Registro de auditoría

Producción
Espacio de trabajo
Producción
Recurso
Agente de entrega
WhatsApp
Acceso de lecturaLectura y escritura
Completado

Empieza con eSIM.
Construye en todos los canales con Bird.

Tu próxima idea. Lista para conectar.