Boomerangme icon

Boomerangme

Interact with Boomerangme API

Overview

The "Subtract Stamp From Card" operation in the Boomerangme node allows users to decrement a specified number of stamps from a digital card. This is useful in loyalty or rewards programs where customers accumulate stamps for purchases or visits, and sometimes need to have stamps removed due to returns, corrections, or adjustments.

Practical examples include:

  • Correcting an error where too many stamps were added.
  • Removing stamps when a customer redeems part of their rewards.
  • Adjusting stamp counts after a refund or cancellation.

This operation helps maintain accurate tracking of customer loyalty points or stamps on digital cards.

Properties

Name Meaning
Card ID The unique identifier of the card from which stamps will be subtracted.
Stamps The number of stamps to subtract from the card.
Comment An optional text comment explaining the reason for subtracting stamps (e.g., "Refund adjustment").

Output

The output JSON typically contains the updated state of the card after the subtraction operation. This includes details such as the new stamp count and possibly metadata about the transaction (like timestamps or comments). The exact structure depends on the API response but generally reflects the card's current status post-update.

No binary data output is expected from this operation.

Dependencies

  • Requires an active connection to the Boomerangme API via an API key credential.
  • The node must be configured with valid authentication credentials to access the Boomerangme service.
  • Network connectivity to https://api.digitalwallet.cards/api/v2 is necessary.

Troubleshooting

  • Invalid Card ID: If the provided Card ID does not exist or is malformed, the API may return an error indicating the card was not found. Verify the Card ID before running the operation.
  • Insufficient Stamps: Attempting to subtract more stamps than currently available on the card might cause an error or fail silently depending on API behavior. Ensure the card has enough stamps before subtracting.
  • Authentication Errors: Missing or invalid API credentials will prevent the operation from succeeding. Confirm that the API key is correctly set up in n8n credentials.
  • Network Issues: Connectivity problems can cause timeouts or failures. Check network access to the Boomerangme API endpoint.

Links and References

Discussion