Query top-up offers matched to the existing eSIM.
Catalog plans covering the same country are not automatically compatible with an already provisioned profile. List compatible offers for that specific eSIM in the dashboard or API, and confirm no pending order or package limit blocks the purchase. Even a dormant expired eSIM can return to active service when it supports a compatible top-up.
Show separate package validity and service boundaries.
Each top-up adds a distinct data package with its own gigabyte allowance, activation rule, and expiration date rather than extending the original package’s timer. If the eSIM’s overall service window would shorten the new package’s validity, Bird surfaces the effective end date before you confirm the order.
Display usage timestamps and recover interrupted orders.
Carrier usage reports can lag live handset consumption, so display the observation timestamp alongside remaining gigabytes and keep unmeasured balances distinct from zero. Save the order ID and idempotency key when submitting a top-up so your app checks the existing purchase instead of charging the customer twice.