Actions23
- Customer Actions
- Card Actions
- Add Amount to Card
- Add Point to Card
- Add Reward to Card
- Add Scores to Card
- Add Stamp to Card
- Add Visit to Card
- Create Card
- Delete Card
- Get Card
- List of Cards
- Receive Reward
- Redeem Coupon
- Subtract Amount From Card
- Subtract Point From Card
- Subtract Reward From Card
- Subtract Scores From Card
- Subtract Stamp From Card
- Subtract Visit From Card
- Company Actions
- SMS Actions
Overview
The node integrates with the Boomerangme API to manage digital wallet cards and their associated rewards. Specifically, the "Add Reward to Card" operation allows users to add a specified number of rewards to a particular card identified by its Card ID. This is useful in loyalty programs or customer engagement scenarios where businesses want to track and reward customer activities digitally.
Practical examples include:
- Adding reward points to a customer's loyalty card after a purchase.
- Incrementing rewards for promotional campaigns.
- Tracking bonus rewards given during special events.
Properties
| Name | Meaning |
|---|---|
| Card ID | The unique identifier of the card to which rewards will be added. |
| Rewards | The number of rewards to add to the specified card. |
| Comment | An optional text comment describing the reason or context for adding the rewards. |
Output
The node outputs JSON data representing the response from the Boomerangme API after adding rewards to the card. This typically includes updated card information such as the new rewards balance and any metadata returned by the API.
If the API supports binary data (e.g., images or documents related to the card), it would be included accordingly, but based on the provided code and properties, the primary output is JSON structured data reflecting the updated card state.
Dependencies
- Requires an active connection to the Boomerangme API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- The base URL for API requests is
https://api.digitalwallet.cards/api/v2. - Proper configuration of the "Boomerangme" credential within n8n is necessary.
Troubleshooting
- Invalid Card ID: If the 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 node.
- Insufficient Permissions: Errors related to authorization usually mean the API key or token lacks required permissions. Ensure the credential has rights to modify card rewards.
- Network Issues: Connectivity problems can cause request failures. Check network access and API availability.
- Invalid Rewards Value: Providing a non-numeric or negative value for rewards might cause errors. Ensure the rewards property is a positive number.
- API Rate Limits: Frequent calls might hit rate limits imposed by the API. Implement retries or backoff strategies if needed.
Links and References
- Boomerangme API Documentation (Assumed official docs URL)
- n8n Documentation on Creating Custom Nodes
- General info on Digital Wallet Cards and Loyalty Programs