Top-up
Last updated
Was this helpful?
Last updated
Was this helpful?
Was this helpful?
Once the First Package has been activated, you can add more balance to your Gigastore Customer via the /gigastore/activations/top-up
endpoint.
Please note that Top-ups can only be activated for existing Gigastore Customer and must match the CountrySet
during the initial activation.
inventoryItemId - see Offering Packages
metatag, e.g. an internal transaction id (will be stored and can be retrieved via API)
customerUid - the uid of your customer as returned during registration
expectedPrice - the retail price of the package (optional)
activationMode - type of package activations (optional) see Activation Modes
Top-ups are consumed in order of shortest remaining validity.
Inactive FIRST_USE top-ups will not be used until all active package(s) are empty or expired.
Multiple inactive FIRST_USE top-ups activate in order of the closest expiresAt
date, usually matching the purchase order.
ON-DEMAND top-ups can be stacked and will remain inactive until manually triggered via API.
Top-ups activate and take priority for usage automatically based on coverage area, even if other plans are active.
POST /gigastore/activations/top-up
Request:
{
"inventoryItemId": "00e3e46e-faa5-465a-9321-1234567890",
"metatag": "Comment for reseller...",
"customerUid": "123234345-234-cbd2-9321-1234567890",
"expectedPrice":{
"sortIndex": 0,
"priceValue": 4.99,
"currencyCode": "USD"
},
"activationMode": "NOW"
}
Response:
{
"status": "success",
"activatedItem": {
"balance": {
"activatedAt": "2024-04-30T10:41:03.14304Z",
"expiresAt": "2025-04-30T10:41:03Z",
"activationMode": "NOW",
"name": "eSIM Worldwide 50 MB",
"size": {
"sizeValue": 50,
"sizeUnit": "MB"
},
"availableBalance": {
"sizeValue": 0.05,
"sizeUnit": "GB"
},
"validitySize": 365,
"validityUnit": "days"
},
"uid": "4f1eec1b-61dc-47df-91a6-....",
"metatag": "Comment for reseller...",
...
},
"customer": {
"email": null,
"uid": "123234345-234-cbd2-9321-1234567890",
"profileUrl": "<url>"
},
"esimProfile": null
}
The request will return a newly created activatedItem.
The customer's total balance will be updated immediately. See Customers for more details.