Member Coupon ID vs Coupon ID

Understanding the distinction between Coupon ID and Member Coupon ID is crucial for performing specific tasks efficiently and integrating APIs seamlessly.

Definitions

Coupon ID

  • Represents the ID of the coupon.
  • It is the UUID visible in the URL when viewing a coupon in the CC.

Member Coupon ID

  • Refers to the unique instance of a coupon that has been redeemed or assigned to a specific member.
  • Each member receives their own copy of the coupon upon redemption, which generates a unique Member Coupon ID.
  • This ID is created and managed by the system to ensure that each instance of the coupon is tied to a specific member, allowing precise tracking and redemption.

Key Differences

AspectCoupon IDMember Coupon ID
PurposeIdentifies the general coupon templateIdentifies the specific coupon instance for a member
ContextVisible in the Content Cockpit (in URL)Returned when querying member-specific coupons via the API
UniquenessShared among all instances of the couponUnique to each member's redeemed instance

Example Use Case

Scenario: Two members activate the same coupon

  • Coupon ID remains the same for both since it points to the shared coupon template.
  • Member Coupon ID differs, as each receive their own unique instance of the coupon.

API Notes

When calling API GET ACTIVATED COUPONS to fetch a list of coupons:

  • The response includes Member Coupon IDs at the beginning and then also Coupon ID.
  • This allows the system to distinguish between individual coupon instances for different members.

To redeem a coupon for a specific member, you will need to:

  1. Get the Member Coupon ID calling API GET ACTIVATED COUPONS.
  2. Call API REDEEM A MEMBER COUPON.