Overview

This article catalogs the error messages you may encounter while synchronizing data between iPaaS.com and 99minds, grouped by mapping collection flow. Each entry describes what the error means and how to resolve it.

When a transfer to 99minds fails, iPaaS.com records the error in the subscription's error logs prefixed with Unable to process transfer. Reason: followed by the message shown below. For example, an invalid campaign produces Unable to process transfer. Reason: Gift Card creation failed: Invalid campaign_id.

Supported Flows

Add/Update 99minds Gift Card FROM iPaaS.com
Add 99minds Customer FROM iPaaS.com

Add/Update 99minds Gift Card FROM iPaaS.com

Amount not greater than zero

Error message: Gift Card creation failed: Amount must be greater than zero.

Description: A Gift Card cannot be issued with a zero or negative amount. The amount comes from the iPaaS.com Gift Card Balance.
Resolution: Confirm the iPaaS.com Gift Card has a Balance greater than 0 before transferring. Active gift cards with a remaining balance are the only records the collection processes.

Campaign Id missing

Error message: Gift Card creation failed: CampaignId is required. Provide it via field mapping or the 'Campaign Id' preset.

Description: 99minds requires a campaign to issue a Gift Card, and none was supplied.
Resolution: Set the Campaign Id subscription preset to a valid 99minds campaign (found under Programs in the 99minds portal), or map the campaign as a field on the collection.

No customer identifier

Error message: Gift Card creation failed: At least one customer identifier is required (CustomerEmail, CustomerId, or ClientCustomerId with ClientCustomerPlatform).

Description: A Gift Card must be linked to a customer, but no usable customer identifier was resolved from the iPaaS.com record.
Resolution: Make sure the Gift Card resolves a customer — map ReceivingCustomerEmail, or confirm the record's CustomerId links to a 99minds customer. Transfer the customer to 99minds first if it has not been synced.

Invalid campaign or other 99minds rejection (creation)

Error message: Gift Card creation failed: [message returned by 99minds]

Description: 99minds rejected the Gift Card issuance and returned a reason. A common example is Invalid campaign_id, which means the supplied Campaign Id does not match a campaign in 99minds.
Resolution: For Invalid campaign_id, verify the Campaign Id matches a valid campaign under Programs in 99minds. For other messages, review the reason 99minds returned along with the card and customer values being sent. If the cause is unclear, contact iPaaS.com Support.

Card already issued (duplicate)

Error message: The card is already issued or sold

Description: 99minds rejected the issuance because a Gift Card with the same card number already exists. When collision handling is enabled, the integration recovers automatically — it finds the existing card by its number and completes the transfer as an update instead of creating a duplicate.
Resolution: No action is needed when collision handling is configured and the Customer Card Number is set and unique. To control how duplicates are handled, set the Collision Handling Method on the mapping collection to your preferred behavior (Error, Remap and Link, Update and Link, or Update and No Link). If recovery does not occur, confirm the Customer Card Number is mapped and unique.

Card reference missing (update)

Error message: Gift Card update failed: Either CardId or GiftCardNumber is required.

Description: Updating a Gift Card requires either the linked 99minds card id or a card number to locate the card, and neither was available.
Resolution: Confirm the Gift Card was previously issued and linked, or that a Customer Card Number is mapped so the card can be located in 99minds.

Card not found by number (update)

Error message: Gift Card update failed: Could not resolve CardId for GiftCardNumber '[card number]'.

Description: The integration looked up the Gift Card by its number in 99minds but found no match.
Resolution: Confirm the card number exists in 99minds and is spelled exactly as stored. If the card was issued through a different system, verify it is present in the 99minds account being synced.

Negative update amount

Error message: Gift Card update failed: Amount must be zero or greater.

Description: A Gift Card balance cannot be reconciled to a negative value.
Resolution: Confirm the iPaaS.com Gift Card Balance is zero or greater before transferring.

Current card state unavailable (update)

Error message: Gift Card update failed: Could not retrieve current card state for card_id '[card id]'.

Description: The integration could not load the existing 99minds card before reloading or redeeming — for example, the linked card id no longer resolves in 99minds.
Resolution: Confirm the card still exists in 99minds. If it was deleted or voided in 99minds, the iPaaS.com record can no longer be reconciled to it.

Balance could not be read (update)

Error message: Gift Card update failed: Unable to parse current balance '[value]'.

Description: 99minds returned a card balance the integration could not interpret as a number.
Resolution: Contact iPaaS.com Support — this indicates unexpected data returned by 99minds for the card.

Reload rejected by 99minds

Error message: Gift Card reload failed: [message returned by 99minds]

Description: 99minds rejected the reload (balance increase) and returned a reason.
Resolution: Review the reason 99minds returned. Confirm the card is active and eligible for reload. If the cause is unclear, contact iPaaS.com Support.

Redeem rejected by 99minds

Error message: Gift Card redeem failed: [message returned by 99minds]

Description: 99minds rejected the redeem (balance decrease) and returned a reason.
Resolution: Review the reason 99minds returned. Confirm the card is active and has sufficient balance to redeem. If the cause is unclear, contact iPaaS.com Support.

Add 99minds Customer FROM iPaaS.com

Customer could not be created

Error message: Customer creation failed

Description: 99minds could not create the customer from the iPaaS.com record.
Resolution: Confirm the customer has a valid email address (required by 99minds) and retry the transfer. If a customer with the same email already exists in 99minds, it is reused rather than recreated. If the failure persists, contact iPaaS.com Support.

99minds Error Messages