Summary

99minds Gift Cards are created and updated in iPaaS.com from 99minds Gift Card webhook events. When a Gift Card event occurs in 99minds, the integration syncs the card's current state — balance, status, customer details, and campaign information — into the corresponding iPaaS.com Gift Card record.

ID Format

Manual Sync ID Format

On the iPaaS.com Manual Sync page, enter the 99minds Gift Card card id — for example, card_1eaa3f7f34e041791d.

External ID Format

After a successful transfer, the 99minds Gift Card card id is saved as the external-id link. Subsequent webhook events use this link to update the same iPaaS.com Gift Card rather than creating a duplicate.

Deleted Record Support

Outbound delete is not applicable to this inbound direction, and Gift Cards are not deleted in iPaaS.com by this collection. Lifecycle changes such as deactivation, blocking, or voiding arrive as webhook events that update the card's Status rather than removing the record.

Mapping Collection Status

Status: Enabled.
Trigger Events: 99minds Gift Card webhook events (see Supported Webhook Events). Manual Sync is also available. Whether an event creates or updates the iPaaS.com Gift Card is determined by whether the card is already linked by an external id, not by which event fired.

Supported Webhook Events

These webhook events must be configured manually in 99minds (Settings → Webhooks → Manage → New Webhook) using your iPaaS.com subscription Webhook API Key — see the 99minds Installation Instructions. No automatic transfers occur until the 99minds webhook is configured.

giftcard.activated
giftcard.deactivated
giftcard.blocked
giftcard.voided
giftcard.reloaded
giftcard.extend_expiry
giftcard.amount_loaded
giftcard.redeemed

Duplicate or Conflicting Mappings

The Add/Update 99minds Gift Card FROM iPaaS.com collection moves the same Gift Cards in the opposite direction (iPaaS.com → 99minds). Decide which system is the source of truth for the card balance so the two directions do not overwrite each other.

Collision Handling

Collision handling is not supported for this direction (TO iPaaS.com). Whether an incoming event creates or updates the iPaaS.com Gift Card is determined by whether the card is already linked by an external id.

Supported Child Collections

None — this is a standalone collection with no dependent child collections.

System Caveats

99minds Caveats

All Gift Card events route to the Update scope action and into this single collection; each event carries the card's full current state.

iPaaS.com Caveats

A customer link is not required to create the Gift Card. When the 99minds customer has no linked iPaaS.com customer, the Customer Id is left empty and the transfer still proceeds.
The six campaign/card custom fields must already exist on the iPaaS.com Gift Card configuration before they can be populated.

Setup Requirements

iPaaS.com Configuration

Ensure the six 99Minds Gift Card custom fields exist on the iPaaS.com Gift Card (Subscription Settings → Custom Fields).

99minds Configuration

Configure the Gift Card webhook events (listed above) in 99minds (Settings → Webhooks → Manage), using the iPaaS.com subscription Webhook API Key.

Authentication & Security

Authentication uses the 99minds API key / Webhook API Key configured on the subscription — see the 99minds Installation Instructions.

Integration Flow

99minds sends a Gift Card webhook event to iPaaS.com.
Resolve the iPaaS.com customer linked to the card's 99minds customer; if none is linked, the Customer Id is left empty and the transfer continues (a customer link is not required).
Create or update the iPaaS.com Gift Card record with the card's current state, routing to Add or Update based on whether the card is already linked by an external id.

Mappings

Add/Update 99minds Gift Card TO iPaaS.com

This mapping collection does not have a mapping filter applied. All incoming Gift Card webhook events are processed.

Description: Creates or updates the iPaaS.com Gift Card record from the 99minds Gift Card event payload, including balance, status, customer details, and campaign metadata.

Mapping Type	Source Field (99minds)	Destination Field (iPaaS.com)	Description
Field	GiftCardNumber	Number	Required. Primary identifier for the iPaaS.com Gift Card record.
Field	Balance	Balance	Required. Current remaining balance on the card.
Dynamic Formula	(see formula below)	Status	Resolved from the card's active state: Active when active, otherwise Pending.
Static	`"Gift Card"`	Type	Always set to Gift Card; a genuine constant for this collection.
Dynamic Formula	`SpaceportSystemId`	Originating_SystemId	The originating system id the card is created from.
Dynamic Formula	(see formula below)	CustomerId	Resolves the iPaaS.com customer linked to the 99minds customer; empty when none is linked (customer link is optional).
Field	CustomerName	ReceivingCustomer	Recommended. Recipient name shown on the iPaaS.com record.
Field	CustomerEmail	ReceivingCustomerEmail	Recommended. Recipient email on the iPaaS.com record.
Field	CreatedAt	PurchaseDate	When the card was created in 99minds.
Field	ExpirationDate	ExpirationDate	When the card expires; updated when expiry is extended.
Field	OriginalValue	OriginalAmount	The card's original issued value.
Field	TransactionDescription	Description	Description from the 99minds transaction.
Field	CampaignId	99Minds Gift Card Campaign ID	Custom field. The 99minds campaign the card was issued under.
Field	CampaignName	99Minds Gift Card Campaign Name	Custom field. Readable campaign name.
Field	DeliveryMode	99Minds Gift Card Delivery Mode	Custom field. How the card was delivered.
Field	CurrencyCode	99Minds Gift Card Currency Code	Custom field. Currency the balance is denominated in.
Field	BatchId	99Minds Gift Card Batch ID	Custom field. Batch the card was issued in.
Field	CustomerId	99Minds Gift Card Customer ID	Custom field. The 99minds customer id on the card.

Status formula:

Active ? "Active" : "Pending";

CustomerId formula:

await GetSpaceportIdAsync(CustomerId, "Customer", SpaceportSystemId);

This formula looks up the iPaaS.com customer linked to the 99minds customer id. If a link exists it returns the iPaaS.com customer id; otherwise it returns empty and does not halt the transfer, because a customer link is not required for a Gift Card.

Testing & Validation

Test Scenarios

Create — send a giftcard.activated event for a new card and confirm an iPaaS.com Gift Card is created with the matching number, balance, status, and campaign custom fields.
Update — balance — send a giftcard.reloaded or giftcard.redeemed event and confirm the iPaaS.com Balance updates on the same card.
Update — status — send giftcard.deactivated / giftcard.blocked / giftcard.voided and confirm the iPaaS.com Status reflects the change (no duplicate record).
Expiry — send giftcard.extend_expiry and confirm the iPaaS.com Expiration Date updates.
Customer link — send an event for a card whose 99minds customer has a linked iPaaS.com customer and confirm Customer Id is populated; send one with no linked customer and confirm the transfer still succeeds with Customer Id empty.
Custom fields — confirm the six 99Minds Gift Card custom fields populate when present on the iPaaS.com Gift Card configuration.

Validation Checklist

Gift Card events create or update the matching iPaaS.com Gift Card with no duplicates.
Status reflects the card's active state; balance reflects reload/redeem/load events.
Campaign custom fields populate when configured.
Cards with no linked customer still transfer.

Additional Notes

All eight Gift Card events route to the Update scope action and into this single collection.
Gift Card transfer to iPaaS.com is an evolving area of the integration; confirm the available webhook events against your 99minds configuration.

99minds to iPaaS.com Gift Card Mapping Documentation