Before you begin, obtain the following authentication information from 99minds.
Log in to your 99minds account.
In the 99minds Dashboard, click Settings, and under API select Manage. 99minds displays the Applications page.
On the App Name line, click to reveal the Key Secret. Copy this value and store it securely — you will need it to install the integration.
Click the back button, then click Manage under Stores.
Copy the Store Reference ID and Client Store ID and store them securely. 99minds requires one of these for Gift Card transfers; you can use a single store for all transactions or create one store per physical location to track where each transaction occurs.
Note: The iPaaS.com platform must be included in any 99minds workflows that you want to run through iPaaS.com (Configure > Workflow Settings, add iPaaS to the platform list).
Installation Instructions for Integration Setup
Go to Subscriptions Management > Subscriptions and click Search Certified Integration Marketplace and Subscribe.
Click the 99minds integration tile.
On the Subscription Detail page, click Subscribe.
Enter a name for the subscription and select a version. The name can be any relevant, unique value within the company where the subscription is created.
Format: [Product Name] - [Environment/Purpose]
Example: 99minds - Release
Select Create Default Mappings (recommended). Leave this unchecked only if you intend to build all mapping collections manually.
Enter the API URL for your 99minds instance.
Production:
https://api.giftcard.99minds.ioDemo / Sandbox:
https://api.demo.giftcard.99minds.io
Enter the API Secret Key. This is the 99minds Key Secret from the Before You Begin steps.
For Gift Card transfers to 99minds, enter the Store Ref Id (the 99minds Store Reference ID) or Client Store Id (the 99minds Client Store ID). 99minds requires one of these on every write — use only one.
For Gift Card issuance, enter the Campaign Id (from 99minds Programs).
Enter the API Throttle Limit. This controls how many API requests can run within the throttle window, protecting system performance and ensuring fair usage.
Initial Setup: 5
Ongoing Operations: 500
High Volume: 500
Enter the API Throttle Seconds. This defines the time window over which the API Throttle Limit is measured. Requests beyond the limit within the window are rejected until the window resets.
Default Value: 60 seconds
Enter the number of Concurrent Connections. This is the maximum number of simultaneous API connections that 99minds can process for the integration. Requests beyond this limit are queued or rejected until an active connection finishes.
Default Value: 10
Click Apply to save the settings.
Authentication Configuration
The integration authenticates to 99minds with a single API Secret Key, sent as a Bearer token on every request.
API Secret Key
Location: 99minds Settings > API > Manage (the Key Secret on the App Name line). It is also available under Settings > Configuration > Integrations > POS > iPaaS.com > Manage.
Description: Authenticates every request the integration makes to the 99minds API.
Store Ref Id / Client Store Id (optional)
Location: 99minds Settings > Stores > Manage.
Description: Attribute gift card transactions to a specific 99minds store. Use only one.
Campaign Id (conditional)
Location: 99minds Programs — the campaign details or URL.
Description: Required only when issuing gift cards from iPaaS.com.
Webhooks Setup
Webhooks to iPaaS.com must be configured manually in 99minds. You will first need the Webhooks API Key from your iPaaS.com subscription.
On the iPaaS.com 99minds subscription settings page, click the copy icon at Webhooks API Key.
In 99minds, navigate to Settings > Webhooks > Manage.
On the Webhooks page, click New Webhook. In the Add Webhook Endpoint dialog, enter the following:
URL (A):
https://api.ipaas.com/HookApi/v2/dynamic/_99minds(production environment).Events (B): Select the customer, loyalty point, and gift card events you want to send to iPaaS.com (for example, customer created/updated/deleted, loyalty point credited/debited, and the gift card events listed under Gift Card Webhooks below).
Custom Headers (C):
Key: Token — Value: the iPaaS.com subscription Webhooks API Key.
Key: Scope — Value: the matching scope for the event (for example, customer/updated). For gift card events, the iPaaS.com receiver reads the event name from the webhook payload, so a Scope header is not required for them — see Gift Card Webhooks below.
Click Create.
Note: No automatic transfers from 99minds to iPaaS.com occur until the 99minds webhook is configured.
Gift Card Webhooks
To bring 99minds gift card changes into iPaaS.com, configure a 99minds webhook to the same receiver URL (https://api.ipaas.com/HookApi/v2/dynamic/_99minds) with the Token header set to your Webhooks API Key, and select the gift card events you want to send. iPaaS.com reads the event name from the webhook payload, so no Scope header is required for gift card events.
The supported 99minds gift card events are:
giftcard.activated — a gift card is activated.
giftcard.deactivated — a gift card is deactivated.
giftcard.blocked — a gift card is blocked.
giftcard.voided — a gift card is voided.
giftcard.reloaded — a gift card balance is reloaded.
giftcard.amount_loaded — an amount is loaded onto a gift card.
giftcard.redeemed — a gift card is redeemed.
giftcard.extend_expiry — a gift card's expiry is extended.
These events trigger the gift card transfer to iPaaS.com — without them, gift card changes made in 99minds are not sent. 99minds publishes a sample payload for every event in its API documentation; use those samples to confirm the events you enable.
Post-Installation Verification
After completing the installation, perform these tests to verify it.
Data Sync Test
Initiate a sample data pull (to iPaaS.com).
Initiate a sample data push (from iPaaS.com).
Functionality Test
Run an end-to-end business process.
Validate key behaviors such as field mappings and webhook triggers.
Review the integration logs in iPaaS.com.
Support and Troubleshooting
Click the Help button on any iPaaS.com page to contact Support or search the documentation. Additional resources:
Documentation: Search at the top of the Help Center.
Support Portal: Use the Help and Support button at the lower-right of any iPaaS.com page.
Contact Information: Contact iPaaS.com.
Related Documents
Setup & Reference
Mapping Documentation