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 loyalty cards. Specifically, the "Add Point to Card" operation allows users to add a specified number of points to a particular loyalty card identified by its Card ID. This is useful in scenarios where businesses want to reward customers for purchases or activities by incrementing their points balance on a digital card.
Practical examples include:
- Adding reward points after a customer completes a purchase.
- Incrementing points as part of a promotional campaign.
- Tracking customer engagement by updating their points tally.
Properties
| Name | Meaning |
|---|---|
| Card ID | The unique identifier of the loyalty card to which points will be added. |
| Points | The number of points to add to the specified card. |
| Comment | An optional text comment describing the reason or context for adding points (e.g., "Bonus"). |
Output
The node outputs JSON data representing the response from the Boomerangme API after adding points to the card. This typically includes updated card details such as the new points balance and any metadata related to the transaction.
If the node supports binary data output, it would represent associated files or media returned by the API, but based on the provided code and properties, the primary output is JSON reflecting the updated card state.
Dependencies
- Requires an active connection to the Boomerangme API endpoint at
https://api.digitalwallet.cards/api/v2. - Needs an API authentication token credential configured within n8n to authorize requests.
- The node depends on the Boomerangme API being available and responsive.
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 is correct.
- Insufficient Permissions: Missing or invalid API credentials can cause authorization errors. Ensure the API key/token is valid and has permissions to modify cards.
- Points Value Issues: Providing a non-numeric or negative value for points might result in validation errors. Confirm that the points value is a positive number.
- Network Errors: Connectivity issues to the Boomerangme API endpoint will prevent execution. Check network settings and API availability.
- API Rate Limits: Excessive requests may trigger rate limiting; handle such errors by implementing retries or backoff strategies.
Links and References
- Boomerangme API Documentation (general reference for API endpoints and usage)
- n8n Documentation for configuring API credentials and using HTTP request nodes.