Top-up

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.

The activation will use your credit balance on Gigastore and deduct the purchase value from your credit. You can check for the history of activations here: https://dent.giga.store/#/your-store/history.

To activate a top-up, you need:

  • 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-up behavior

  • 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.

The top-up is instantly usable by your user; no additional eSIM needs to be installed.

Last updated

Was this helpful?