Digital Wallet Cards icon

Digital Wallet Cards

Interact with Digital Wallet Cards loyalty program API

Overview

The node interacts with a Digital Wallet Cards loyalty program API, specifically managing operations related to loyalty cards. The "Set Membership Tier" operation allows users to update the membership tier of a specified card. This is useful in scenarios where a customer's loyalty status changes (e.g., upgrading or downgrading their membership level) and you want to reflect that change in the digital wallet system.

Practical examples:

  • Automatically upgrade a customer's card to a premium tier after reaching a spending threshold.
  • Downgrade membership tier when a subscription expires.
  • Synchronize membership tiers from an external CRM or loyalty management system.

Properties

Name Meaning
Membership Tier New membership tier for the card

This property is required and expects a string value representing the new membership tier to assign to the card.

Output

The output JSON contains the updated card information after setting the membership tier. It typically includes fields such as the card's ID, updated membership tier, and other card details returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Digital Wallet Cards API.
  • The node makes HTTP POST requests to the endpoint /api/v2/cards/{cardId}/set-membership-tier.
  • The base URL for the API is https://api.digitalwallet.cards.
  • No additional environment variables are explicitly required beyond the API authentication setup.

Troubleshooting

  • Missing Required Fields: If either the card ID or membership tier is not provided, the node will throw an error indicating missing required parameters.
  • Invalid Card ID: Providing an invalid or non-existent card ID will result in an API error; verify the card ID correctness.
  • API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Network Issues: Connectivity problems may cause request failures; check network access to the API endpoint.
  • Unexpected API Responses: If the API returns unexpected data or errors, review the API documentation or contact support.

Links and References

Discussion