DENT Gigastore Documentation
  • Introduction
  • Start with Gigastore
    • Create an Account
    • Add Credits
    • Configure Inventory
    • Set Up Auto Top-Up for Credits
  • Technical Integration
    • API Integration
    • SDK Integration
  • API
    • Getting started
    • Open API Specification
    • Postman Collection
    • API Authentification
    • Offering Packages
    • Countries API
    • Supported Devices API
    • Customers
    • First Package
    • Activation Modes
    • eSIM Profiles
    • Top-up
    • Package Refund
    • Error Handling
  • Webhooks
    • First Steps
    • eSIM Status
    • Balance Alert
    • Country Change
  • iOS SDK
    • First Steps
    • Download SDK
    • Enable Direct Installation
    • iOS Universal Link
    • Integrate SDK
    • Prepare eSIM Installation
    • Install eSIM
  • Android SDK
    • First Steps
    • Download SDK
    • Enable Direct Installation
    • Integrate SDK
    • Prepare eSIM Installation
    • Install eSIM
    • Testing
  • SDK Webhooks
    • Activation Request
    • Customer Registration
  • Guidelines
    • UX Guide
  • Customer support
    • Gigastore for Support Teams
    • Connectivity
    • Changing Device
    • Package Refund
Powered by GitBook
On this page
  1. API

Top-up

PreviouseSIM ProfilesNextPackage Refund

Last updated 7 days ago

Was this helpful?

CtrlK

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.

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.