Boomerangme icon

Boomerangme

Interact with Boomerangme API

Overview

The "Subtract Visit From Card" operation in the Boomerangme node allows users to decrement a specified number of visits from a loyalty or membership card. This is useful in scenarios where a customer redeems visits or when correcting an overcount of visits on a card. For example, if a customer uses two visits for services but only one was previously recorded, this operation can subtract the extra visit to keep the card's visit count accurate.

Properties

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

Output

The node outputs JSON data representing the updated state of the card after the subtraction of visits. This typically includes fields such as the card's current visit count and any metadata returned by the API confirming the update. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the Boomerangme API.
  • The node makes HTTP requests to the Boomerangme API endpoint at https://api.digitalwallet.cards/api/v2.
  • Proper configuration of the API credential within n8n is necessary for successful execution.

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 is correct.
  • Insufficient Visits: Attempting to subtract more visits than currently available on the card might cause an error or unexpected behavior. Ensure the number of visits to subtract does not exceed the card’s current visit count.
  • Authentication Errors: Missing or invalid API credentials will result in authentication failures. Confirm that the API key credential is correctly set up in n8n.
  • Network Issues: Connectivity problems can prevent communication with the API. Check network settings and API availability.

Links and References

Discussion