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 "Add Points" operation on the "Card" resource allows users to add loyalty points to a specific digital wallet card. This is useful in scenarios where businesses want to reward customers for purchases, engagement, or other activities by increasing their points balance on a loyalty card.
Practical examples include:
- Adding points after a customer completes a purchase.
- Rewarding customers for participating in promotions or events.
- Manually adjusting points balances for customer service reasons.
This operation ensures that the points addition is tracked with optional descriptions and transaction IDs for auditing and reconciliation.
Properties
| Name | Meaning |
|---|---|
| Amount | The number of points to add to the card. Must be a non-negative number with up to 2 decimals. |
| Description | Optional text describing the reason or context for adding points. |
| Transaction ID | Optional unique identifier for the transaction to help track or reference it. If not provided, one is generated automatically. |
Output
The output JSON contains the response from the API after adding points to the card. It typically includes details about the updated card state or the transaction confirmation. The exact structure depends on the API but generally confirms success and may include updated point balances.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential configured in n8n to authenticate requests to the Digital Wallet Cards API.
- The node makes HTTP POST requests to the endpoint
/api/v2/cards/{cardId}/add-point. - The node uses utility functions for request handling, parameter validation, and response transformation bundled within the node's codebase.
Troubleshooting
- Missing Required Fields: Errors will occur if
cardIdoramountare not provided. Ensure these are set correctly. - Invalid Amount: The amount must be zero or positive; negative values will cause errors.
- API Authentication Errors: Verify that the API key credential is valid and has necessary permissions.
- Duplicate Transaction IDs: If specifying a
transactionId, ensure it is unique to avoid conflicts. - Network Issues: Connectivity problems can cause request failures; check network access to the API endpoint.
- Unexpected API Responses: If the API returns errors, review the message for hints (e.g., card not found, insufficient permissions).
Links and References
- Digital Wallet Cards API Documentation (hypothetical link as per typical usage)
- n8n documentation on Creating Custom Nodes
- General best practices for Loyalty Program Management (example external resource)