eSIM

Is an eSIM top-up the same as a renewal?

A top-up adds an eligible allowance or service; a renewal continues a subscription into another billing period under its agreed terms.

A subscriber has unused data when the next payment is due. The purchase terms determine what happens to that balance.

What does a top-up do?

A top-up purchases an eligible additional allowance for an existing service. The provider must support adding that package to the customer’s eSIM profile, the digital SIM used by their device. Coverage overlap alone is not enough to establish that it can be attached.

Present the top-up’s allowance, price, coverage, validity and activation behavior. Explain whether it starts immediately, follows another package or uses a different rule. An added package does not automatically extend the expiry of an older allowance.

What does a renewal do?

A renewal starts another period of a continuing subscription. Before renewal, the app should show the subscriber the period, included service, expected charge and payment method. If renewal fails, the app should show payment recovery separately from service recovery. A successful payment retry does not by itself confirm that connectivity has resumed.

An upgrade or downgrade can take effect at a future period. Keep the requested change separate from the active plan until that date and outcome are confirmed.

What should the purchase interface make clear?

Tell the customer what changes, when it changes and what they are approving. Retain the existing order identity if a response is uncertain. Encouraging another purchase can create an unwanted second charge.

After fulfillment, show the new package or period with its effective terms. Keep any usage observation time visible so a delayed network update is not mistaken for a failed purchase.

In your usage and top-up flow, name the package the customer is buying. For mobile plans, show which billing period continues and when the next charge applies.

In short

  1. Top-ups must match the existing service.

    Two packages covering the same destination are not necessarily interchangeable.

  2. An added allowance has its own effective terms.

    An added package does not automatically extend the expiry of an older allowance.

  3. A renewal is a continuing commitment.

    Show the billing period, included service and payment arrangement before it repeats.

Put it into practice.

Continue with the documentation, guides and examples for this topic. Resources are in English.

Get an implementation brief

Build your mobile service with Bird.

Bring your markets, plan requirements and customer journey. Explore mobile connectivity with Bird and prepare your first service.

Start with one channel.
Add the others when you're ready.

A test API key is yours immediately. Production unlocks when you add a payment method and verify a sender.

Using Claude Code, Cursor, or Codex? Copy a setup prompt and your agent installs the Bird CLI and skills for you. Pick yours:

Cursor