99minds Connections and Settings

Integrate iPaaS.com with 99minds to enable seamless data synchronization for customers, loyalty card transactions, and gift cards.

Prerequisites

Before setting up the 99minds integration in iPaaS.com, gather the following from your 99minds account:

API URL — the base URL for your 99minds instance.
- Production: https://api.giftcard.99minds.io
- Demo / Sandbox: https://api.demo.giftcard.99minds.io
API Secret Key — used to authenticate every request to 99minds.
- In 99minds, go to Settings > Configuration > Integrations. Under POS, locate iPaaS.com and click Manage.
- Copy the generated API Secret Key.
Store Ref Id and Client Store Id — store identifiers required for Gift Card transfers to 99minds (99minds requires one on every write to its API). Use either one.
- In 99minds, go to Settings > Stores > Manage.
- Note the Store Reference ID and Client Store ID columns for the relevant store.
Campaign Id — optional; required only when issuing gift cards from iPaaS.com. In 99minds, open Programs and the relevant campaign; the Campaign ID appears in the campaign details or the URL.
Include iPaaS.com in 99minds workflow platforms — the iPaaS.com platform must be included in any 99minds workflow that should execute through iPaaS.com. Go to Configure > Workflow Settings and add iPaaS to the platform list.

Configure Subscription Settings

In iPaaS.com, open the 99minds subscription settings and provide the following values:

99minds subscription settings in iPaaS.com

Field	Description	Required	Example
Name	A unique name identifying the subscription.	Yes	99minds - Release
Version	The iPaaS.com integration version to use.	Yes	1.0.1
API Url	The base URL for your 99minds instance.	Yes	`https://api.giftcard.99minds.io`
API Secret Key	The key used to authenticate API requests to 99minds.	Yes	Your API Secret Key
Store Ref Id	A 99minds-generated store ID. Required for Gift Card transfers to 99minds — see the note below. Use either Store Ref Id or Client Store Id.	Conditional	store_b81a893dc2bc6e1a5d
Client Store Id	A merchant-provided store ID. Required for Gift Card transfers to 99minds — see the note below. Use either Client Store Id or Store Ref Id.	Conditional	1
Campaign Id	The 99minds campaign used when issuing gift cards. Required for the gift card issuance flow.	Conditional	Your Campaign ID

Note: 99minds requires either a Store Ref Id or a Client Store Id on every write to its API, so a store is required for Gift Card transfers to 99minds. Create at least one store in 99minds (under Stores) and enter its Store Ref Id or Client Store Id here — use only one. You can use a single store for all transactions, or one store per physical location to track where each transaction occurs. Campaign Id must also be set (here or as a mapped field) before gift cards can be issued from iPaaS.com.

Authentication Methods

The 99minds integration authenticates with a single API Secret Key:

Obtain the API Secret Key from 99minds (see Prerequisites).
Enter it in the API Secret Key subscription setting in iPaaS.com.
iPaaS.com sends this key as a Bearer token on every request to the 99minds API. There is no separate token-exchange or login step to configure.

Initialization Support

Currently, initialization is not supported for 99minds in iPaaS.com. All data synchronization and mappings must be configured manually during the integration process.

Throttling

Throttling ensures that the 99minds API is not overwhelmed by excessive API calls, preserving system performance during heavy data transfers. 99minds allows 150 requests per minute per IP address (the same across all plans); requests beyond that limit receive an HTTP 429 response.

While the throttling fields are required, the values are pre-populated by the integration settings to keep request volume within the 99minds limit. For more details, refer to Subscription Configuration – Edit.