API errors

balance_not_available

The eSIM's balance does not exist until the eSIM is activated.

409application/problem+json

What it means

The eSIM is still preactive, so its balance cannot be read or credited yet.

409 · application/problem+json

{
  "type": "https://developers.firsty.app/errors/balance_not_available",
  "title": "Conflict",
  "status": 409,
  "detail": "The balance is available once the eSIM is active",
  "code": "balance_not_available"
}

How to handle it

Wait for the esim.lifecycle.activated webhook, then retry.

Errors reference