Planifica tu integración de eSIM

El acceso público a la API de eSIM aún no está disponible. Esta guía te ayuda a preparar un documento de integración para un especialista en eSIM. Confirma el acceso y obtén el contrato de API compatible antes de implementar solicitudes o asignar un agente para construir la integración.

Identifica quién compra el servicio, quién usa el dispositivo y quién paga. Una compra de viaje puede pertenecer a una sola cuenta de cliente. Un servicio para empleados también necesita una asignación a una persona y un responsable que pueda aprobar cambios.

Enumera los registros que tu aplicación necesita conectar: la compra, el perfil instalado y su asignación de datos. Un servicio móvil recurrente también necesita la relación continua del suscriptor con su plan. Estos son requisitos que debes confirmar contra el contrato del servicio receptor.

Decide dónde ven los clientes la oferta seleccionada, la cobertura, la validez y el precio publicado. Mantén intacta la moneda indicada. Tu aplicación no debe reconstruir una tarifa para el cliente a partir de costos mayoristas o una conversión de moneda estimada.

Para cada compra, define lo que el cliente ve tras la aceptación, el cumplimiento o el rechazo. Incluye un caso de respuesta perdida en el documento de integración. Confirma cómo la API identifica una operación existente antes de diseñar un reintento que podría generar otro cargo.

Un proceso de pago completado no demuestra que un dispositivo haya instalado o usado el servicio. Mantén esos resultados separados en el recorrido del cliente.

Elige los dispositivos compatibles y la persona responsable de ayudar al cliente a conectarse. Las credenciales de instalación necesitan una vía de entrega privada y autorizada. Mantenlas fuera de analíticas, ejemplos públicos y capturas de pantalla de soporte.

Enumera la información que el cliente necesita después de la compra: instrucciones de configuración, el plan adquirido, observaciones de consumo y un contacto de soporte. Confirma qué estados y tiempos de observación puede proporcionar el servicio antes de diseñar la pantalla de estado.

Pide a tu especialista de Bird que confirme los mercados, las ofertas elegibles, los requisitos de acceso y las operaciones publicadas para tu caso de uso. Obtén las definiciones de solicitud y respuesta, los requisitos de autorización, el comportamiento de reintento y los métodos de instalación compatibles.

Cuando ese contrato esté disponible, entrega a tu agente de desarrollo el contrato y el modelo de identidad de tu aplicación. Haz que trace una compra hasta su resultado confirmado y cubra una solicitud rechazada y una respuesta incierta. Prueba con una cuenta y un dispositivo explícitamente autorizados antes de ofrecer el servicio a los clientes.

Preserva el contexto de campaña permitido a lo largo del registro y el recorrido del cliente en tu aplicación. Define qué resultado registrado contará como conversión, por ejemplo una compra completada o un primer uso verificado. Un identificador de campaña en una URL de registro por sí solo no demuestra que una compra posterior haya sido atribuida.