Actions47
- Template Actions
- Communication Actions
- Card Actions
- Create
- Get
- Get All
- Update
- Delete
- Get Balance
- Add Points
- Deduct Points
- Add Amount
- Deduct Amount
- Add Stamps
- Deduct Stamps
- Transfer Points
- Transfer Amount
- Block Card
- Unblock Card
- Generate QR Code
- Get Operations
- Add Visits
- Deduct Visits
- Add Reward
- Deduct Reward
- Receive Reward
- Redeem Coupon
- Set Expiration Date
- Set Membership Tier
- Customer Actions
- Company Actions
- Analytics Actions
- System Actions
Overview
The node interacts with a Digital Wallet Cards loyalty program API, specifically focusing on managing card templates and their reward tiers. The "Create Reward Tier" operation under the "Template" resource allows users to add a new reward tier to an existing card template. This is useful for businesses that want to define different levels of rewards based on customer points, enabling tiered loyalty programs.
Typical use cases include:
- Adding a new membership or reward level to a loyalty card template.
- Defining benefits and requirements for customers to reach a specific tier.
- Customizing the appearance and description of reward tiers to enhance customer engagement.
For example, a retailer might create a "Gold" tier requiring 1000 points, offering benefits like free shipping and priority support, with a distinct color and icon.
Properties
| Name | Meaning |
|---|---|
| Template ID | The numeric identifier of the card template to which the reward tier will be added. |
| Tier Name | The name of the reward tier (e.g., "Gold", "Silver"). |
| Minimum Points | The minimum number of points a customer must have to qualify for this tier. |
| Additional Fields | Optional extra details about the tier: |
| - Benefits | Comma-separated list of benefits included in this tier (e.g., "Free shipping, 10% discount"). |
| - Color | Hex code representing the tier's color (e.g., "#ff6b35"). |
| - Icon | URL or identifier for the tier's icon. |
| - Description | Textual description of the tier. |
Output
The output JSON object represents the newly created reward tier with its properties as returned by the API. It typically includes:
name: The tier name.minimumPoints: The minimum points required.benefits: An array of benefit strings.color: The hex color code.icon: The icon URL or identifier.description: The tier description.- Other metadata fields as provided by the API.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Digital Wallet Cards API.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The node uses internal utility functions for making HTTP requests, validating fields, and formatting data.
Troubleshooting
- Missing Required Fields: If
templateId,name, orminimumPointsare not provided, the node will throw an error indicating these are required. - Invalid Points Value:
minimumPointsmust be zero or positive; negative values will cause validation errors. - API Errors: Errors from the API (e.g., invalid template ID, permission issues) will be surfaced as error messages. Ensure the API key has sufficient permissions.
- Benefits Formatting: Benefits should be a comma-separated string; improper formatting may lead to unexpected results.
- JSON Parsing: If additional fields contain JSON (not applicable here but relevant for other operations), ensure valid JSON syntax.
Links and References
- Digital Wallet Cards API Documentation (hypothetical link)
- Loyalty Program Concepts
- Hex Color Codes Reference
If you need further details on other operations or resources, feel free to ask!