Consulta el consumo y añade una recarga
Usa esta guía para añadir datos a una eSIM existente. Necesitas permiso para leer la eSIM y comprar un paquete, además de fondos suficientes en la cartera. La disponibilidad de recargas depende del perfil, los paquetes existentes y la oferta seleccionada.
1. Consulta los paquetes activos
Abre el perfil desde eSIMs y revisa Data packages. Con API, lista los paquetes de la eSIM y consulta su estado, vencimiento y saldo.
total_bytes es la franquicia comprada. Un valor nulo en used_bytes, remaining_bytes o used_percent significa que no hay medición disponible. Usa balance.as_of para conocer la hora de la última actualización de saldo; antes de que se reporte el consumo, puede corresponder a la hora de entrega del paquete. observed_at es una hora de medición de red cuando se proporciona. Ni un reporte ausente ni uno antiguo confirman que los datos restantes sean cero. El historial de consumo diario no está disponible.
2. Listar ofertas compatibles
Selecciona Top up en la eSIM, o llama a Listar ofertas compatibles para ese perfil. Usa una oferta devuelta en lugar de elegir del catálogo general. Que la cobertura incluya el mismo país no garantiza compatibilidad.
Si una recarga no está disponible, lee available_actions en la eSIM para conocer el motivo. Un pedido sin finalizar o el límite de paquetes puede impedir otra compra. Resuelve el pedido existente antes de intentar de nuevo.
3. Revisar las condiciones efectivas
Muestra la franquicia, la cobertura, el precio y la moneda publicados, y la validez de la oferta seleccionada. Compara la validez del paquete con el período de servicio restante de la eSIM. Una compra que acortaría la validez requiere aceptación explícita mediante acknowledge_shortened_validity.
Una recarga crea un paquete adicional. No modifica el saldo de un paquete existente ni extiende su fecha de vencimiento. Comprueba la activación y el vencimiento del nuevo paquete tras la entrega.
4. Aprobar y dar seguimiento al pedido
Confirma la compra en el panel. Con API, crea un pedido usando el esim_id existente, el offer_id seleccionado, el offer_revision cotizado y expected_price. Guarda el ID de pedido y un Idempotency-Key para reintentos.
Da seguimiento al pedido en Orders, o consulta el pedido a través de API. Revisa status después de ambas respuestas 201 y 202. Si la respuesta se pierde, reintenta la misma solicitud con la misma clave; no crees una compra de reemplazo mientras el resultado sea incierto.
5. Verificar el paquete resultante
Cuando el pedido esté completed, usa su package_id para obtener el nuevo paquete. Confirma que la eSIM de destino, la cobertura y la franquicia coinciden con la compra. Un paquete pendiente de primer uso puede no tener aún marca de tiempo de activación o vencimiento.
Solución de problemas
Si el pedido está completo pero el saldo sigue siendo desconocido, compara el estado del paquete y las marcas de tiempo de los reportes. Los reportes pueden retrasarse respecto al consumo del dispositivo; hacer otro pedido no resuelve ese retraso. Si una compra falla, revisa los detalles del fallo y cualquier referencia de crédito antes de reintentar.
Próximos pasos
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.