Skip to main content

Stamped.io Installation Instructions

How to install and configure the Stamped.io integration in iPaaS.com, including credentials, settings, and post-installation verification.

See what the Stamped.io integration can do →

Before You Begin

Before installing the integration, obtain your Stamped.io API credentials.

  1. Log in to Stamped.io.

  2. In the side menu, go to Settings, then Review Integrations (or Loyalty Integrations), and open API Keys. You will need these values during setup:

    • API Public Key: an authentication credential for external applications. With HTTP Basic authentication, this key acts as the username.

    • API Private Key: an authentication credential for external applications. With HTTP Basic authentication, this key acts as the password. Keep it confidential.

    • Store Hash: directs API requests to the correct store, since Stamped.io can manage multiple stores within one account.

Stamped.io API Keys page

NOTE: Keep this page open while installing the integration — you will need these values to complete setup.

Installation Instructions for Integration Setup

  1. Go to Subscriptions Management and click Search Certified Integration Marketplace and Subscribe.

Subscriptions Management page
  1. Click the Stamped.io integration tile.

Stamped.io marketplace tile
  1. On the Subscription Detail page, click Subscribe.

  2. Enter a subscription name and select a version. Use any relevant, unique name within the company where the subscription is created.

    • Format: [Product Name] - [Environment/Purpose]

    • Example: Stamped.io - Release

  3. Select Create Default Mappings (recommended). To build all mappings yourself instead, leave this box unchecked.

Subscription Settings page
  1. In API Url, enter your Stamped.io API base URL.

  2. Set the throttle and concurrency values (defaults shown; see Operational Configuration for guidance):

    • API Throttle Limit: 500

    • API Throttle Seconds: 60

    • API Throttle Limit (To iPaaS): 500

    • API Throttle Seconds (To iPaaS): 60

    • Concurrent Connections: 2

    • Concurrent Batch Executions: 10

  3. Enter the credential values from your Stamped.io API Keys page (see Authentication Configuration below), then click Apply.

Authentication Configuration

The integration authenticates to Stamped.io using HTTP Basic authentication with your public and private API keys; the store hash directs each request to the correct store. Enter the following credentials on the subscription settings page:

  • API Url: your Stamped.io API base URL (for example, https://stamped.io). This is the base address the integration calls.

  • API Public Key: found on the Stamped.io Settings > Review Integrations > API Keys page (or Loyalty Integrations > API Keys). Used as the Basic-authentication username.

  • API Private Key: found on the same Stamped.io API Keys page. Used as the Basic-authentication password. Keep it confidential.

  • API Store Hash: your Stamped.io store identifier, which directs requests to the correct store.

Important Notes

  • The subscription currently also presents an API User and an API Password field. Enter your API Public Key value in API User and your API Private Key value in API Password. These two fields duplicate the public and private keys and are slated to be consolidated in a future release.

  • The connection is confirmed on the first transfer rather than at save time. After saving, run a Manual Sync of one customer (see Post-Installation Verification) to confirm the credentials are correct. If a credential is wrong, the error appears in the iPaaS.com Dashboard under Integration Monitoring and in the Error Logs.

Operational Configuration

These fields control how quickly the integration calls Stamped.io and iPaaS.com. They are pre-populated with defaults and can be tuned to your store's volume.

  • API Throttle Limit and API Throttle Seconds: the maximum number of calls the integration makes to Stamped.io within each window. Default: 500 calls per 60 seconds. Use a lower limit during initial setup and a higher limit for high-volume stores.

  • API Throttle Limit (To iPaaS) and API Throttle Seconds (To iPaaS): the maximum number of calls made to iPaaS.com within each window. Default: 500 calls per 60 seconds.

  • Concurrent Connections: the maximum number of simultaneous connections the integration opens. Default: 2.

  • Concurrent Batch Executions: the maximum number of batch transfers that run at the same time. Default: 10.

Post-Installation Verification

After setup, run a transfer to confirm both the connection and data synchronization.

Data Sync Test

  1. Go to Data Management > Customer and click Add Customer.

  2. Fill in the required and desired fields per the mapping collection guidelines, then click Apply.

Add or edit a customer
  1. Select Edit on the newly created customer record.

  2. Copy the customer record ID from the browser URL.

Customer record ID in the browser URL
  1. Go to Integration Monitoring > Manual Sync.

  2. Configure the sync:

    • System: Stamped.io

    • Mapping Collection: Add/Update Stamped.io Customer FROM iPaaS.com

    • Scopes: customer/created or customer/updated

  3. Enter the customer record ID in the IPAAS.COM ID field.

  4. Click Debug.

Manual Sync configuration
  1. Repeat the test as an update: edit the same customer, change or add fields, click Apply, then run Manual Sync again with the same settings.

  2. Review the on-screen messages. If there are no errors, the test is successful — this also confirms the connection.

Support and Troubleshooting

Click the Help button on any iPaaS.com page to contact Support or search the documentation. Additional resources:

Stamped.io Support

Related Documents

Did this answer your question?