Digital Wallet CardsInstall

Overview

This node integrates with the Digital Wallet Cards loyalty program API to perform operations related to customers, cards, companies, templates, communications, analytics, and system management. Specifically for the Customer - Get operation, it retrieves detailed information about a customer by their unique identifier.

Typical use cases include:

• Fetching customer details to personalize marketing campaigns.
• Retrieving customer data for CRM synchronization.
• Accessing customer profiles for support or analytics purposes.

Example: Given a customer ID, the node fetches the customer's profile including name, contact info, gender, date of birth, external user ID, and metadata.

Properties

Output

The node outputs JSON data representing the customer object retrieved from the API. This includes fields such as:

• customerId: Unique identifier of the customer.
• firstName: Customer's first name.
• lastName: Customer's last name.
• email: Email address (if available).
• phone: Phone number (if available).
• gender: Gender of the customer.
• dateOfBirth: Date of birth.
• externalUserId: External system user ID for integration.
• metadata: Additional custom metadata associated with the customer.

The output is a single JSON object per input item containing the full customer details as returned by the API.

Dependencies

• Requires an API key credential configured in n8n to authenticate requests against the Digital Wallet Cards API.
• The base URL for API requests is https://api.digitalwallet.cards.
• Uses internal utility functions for making HTTP requests, pagination, validation, and response transformation.

Troubleshooting

• Missing Customer ID: The operation requires a valid Customer ID. If omitted or invalid, the node will throw an error indicating the missing required field.
• API Authentication Errors: Ensure that the API key credential is correctly set up and has sufficient permissions.
• Customer Not Found: If the provided Customer ID does not exist, the API may return an error or empty response; handle this gracefully in workflows.
• JSON Parsing Errors: When updating or creating customers with metadata, ensure JSON strings are well-formed to avoid parsing errors.

Links and References

• Digital Wallet Cards API Documentation (hypothetical link based on base URL)
• n8n Documentation on Creating Custom Nodes
• General REST API best practices for handling customer data securely and efficiently.