Boomerangme icon

Boomerangme

Interact with Boomerangme API

Overview

The "Redeem Coupon" operation on the "Card" resource allows users to redeem a coupon associated with a specific card in the Boomerangme system. This node interacts with the Boomerangme API to perform coupon redemption, which is typically used in loyalty programs or promotional campaigns where customers can redeem coupons linked to their membership or reward cards.

Common scenarios include:

  • A retail store automating coupon redemption when a customer presents their loyalty card.
  • Marketing campaigns where digital coupons are redeemed through an integrated system.
  • Tracking and managing coupon usage directly from within n8n workflows.

Example: When a customer wants to use a discount coupon tied to their loyalty card, this node can be triggered to mark the coupon as redeemed in the backend system.

Properties

Name Meaning
Card ID The unique identifier of the card for which the coupon will be redeemed.
Comment An optional text comment to add context or notes about the coupon redemption action.

Output

The node outputs JSON data representing the response from the Boomerangme API after attempting to redeem the coupon. This typically includes details such as confirmation of redemption, updated card status, or error messages if the redemption failed.

If the API returns any binary data (not indicated in the provided code), it would represent related media or documents, but based on the static analysis, the output is JSON only.

Dependencies

  • Requires an active connection to the Boomerangme API.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://api.digitalwallet.cards/api/v2.
  • Proper configuration of the "Boomerangme" credential in n8n is necessary.

Troubleshooting

  • Invalid Card ID: If the provided Card ID does not exist or is incorrect, the API may return an error indicating the card was not found. Verify the Card ID before running the node.
  • Authentication Errors: Missing or invalid API credentials will cause authorization failures. Ensure the API key/token is correctly set up in n8n credentials.
  • API Rate Limits: Excessive requests might lead to rate limiting by the Boomerangme API. Implement retry logic or reduce request frequency.
  • Missing Required Fields: The Card ID is required; omitting it will likely cause the node to fail or the API to reject the request.
  • Comment Field Usage: While optional, providing comments in an unsupported format or length might cause issues depending on API validation rules.

Links and References

Discussion