Integra conectividad eSIM en tu app
Usa esta guía para vincular una compra de eSIM a una cuenta en tu app. Necesitas un espacio de trabajo Bird, una integración API del lado del servidor y una forma de autenticar a tus clientes. Sigue la guía de API para permisos y detalles de las solicitudes.
1. Muestra ofertas que tu cliente pueda usar
Lista las ofertas para el destino del cliente y muestra la cobertura, el volumen incluido, la validez y el precio publicado de la oferta seleccionada. Verifica la compatibilidad del dispositivo y los requisitos de identificación antes de la compra.
Para la renovación automática, usa las opciones de compra de la oferta para mostrar los modos de compra disponibles y las condiciones aceptadas. Conserva la revisión de la oferta y el precio cotizado junto con la selección del cliente. Si la cotización cambia, muestra las nuevas condiciones y pide al cliente que las acepte antes de comprar.
2. Asocia la compra con tu cliente
Mantén las claves de la API de Bird en tu servidor. Autoriza el acceso a cada pedido y eSIM usando la cuenta de cliente de tu app; una clave API del espacio de trabajo puede acceder a recursos de varios clientes.
Almacena el ID de tu cliente junto con el ID del pedido y, una vez entregado, los IDs de la eSIM y del paquete. Si necesitas un usuario de servicio con nombre o renovación automática, crea un suscriptor a partir de un contacto del espacio de trabajo. La asignación registra quién usa la eSIM; no inicia sesión de esa persona en tu app ni otorga acceso a credenciales.
El monedero de tu organización financia la compra Bird. Si cobras a tu cliente por separado, registra ese pago de forma independiente del pedido de eSIM para que puedas resolver un fallo de pago o de entrega.
3. Crea una compra recuperable
Genera y almacena un Idempotency-Key antes de crear el pedido. Reutiliza esa clave con la misma solicitud si la respuesta se interrumpe.
Muestra un estado de procesamiento hasta que el pedido alcance un resultado final. Guarda el pedido antes de enviar al cliente a la instalación y permite que vuelva a él desde su cuenta. Para un pedido sin fondos o fallido, sigue los pasos de recuperación de compra.
4. Entrega instrucciones de instalación privadas
Cuando el pedido se complete, crea un enlace de instalación alojado para el cliente previsto o envía el enlace por correo electrónico o SMS. Sigue la guía de instalación para entrega, expiración, revocación y configuración del dispositivo.
Trata el enlace y los datos de activación como credenciales. Mantenlos fuera de analíticas, registros públicos y notas rutinarias de soporte. Registra la finalización de la compra, la entrega del enlace y la instalación en el dispositivo como resultados independientes.
Si estás reemplazando un servicio de conectividad existente, planifica una nueva compra e instalación de eSIM Bird. Verifica el dispositivo y el paquete previstos antes de que el cliente modifique su servicio actual. La API de eSIM de Bird no importa un perfil existente ni transfiere un número móvil.
5. Añade una página de cuenta para el uso continuo
Permite que el cliente autenticado reabra su eSIM existente, consulte los saldos y la expiración del paquete reportados, y acceda a soporte. Muestra la marca de tiempo del saldo y los valores desconocidos con precisión.
Usa las ofertas compatibles para recargas y el available_actions de la eSIM para decidir qué controles mostrar. Explica una acción deshabilitada con el motivo devuelto y gestiona un rechazo si la disponibilidad cambia antes del envío. Sigue la guía de paquetes recurrentes para renovación y cancelación.
Verifica la interrupción y la recuperación
Cierra el navegador después de la compra y reabre la cuenta del cliente. Confirma que lleva al mismo pedido y eSIM. Repite después de que comience la instalación.
Comprueba que una respuesta de compra perdida, un enlace de instalación expirado y un valor de uso desconocido conducen a una acción de recuperación adecuada. Verifica que un cliente no pueda abrir el enlace de instalación ni la eSIM de otro cliente a través de tu página de cuenta.
Próximos pasos
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.