Purchase Requirements

A purchase requirement object contains information on required or disqualifying purchases for an offer.

PropertyTypeDescription
minSpendAmountfloatMinimum purchase amount required to redeem
purchaseChannelsPurchaseChannel[]Any PurchaseChannels associated with a potentially qualifying purchase
purchaseTypesPurchaseType[]The PurchaseType associated with a potentially qualifying purchase
merchantUrlLinkClickRequiredbooleanIf a customer needs to click on the merchant url in order to redeem the offer

PurchaseType

The PurchaseType enumeration defines various product types that an offer may be contingent upon.

The values are represented as string in the API response.

ValueDescription
SubscriptionA recurring subscription, such as to an online streaming service or a utility.
MembershipA membership to a club, warehouse store, organization, etc.
FuelGasoline, diesel, etc. Used for gas station offers to require or exclude the purchase of gas for offers.

Examples

This offer requires a fuel purchase from a gas pump:

{
    "minSpendAmount": 5.0,
    "purchaseChannels": ["PayAtPump"],
    "purchaseTypes": [
        "Fuel"
    ],
    "merchantUrlLinkClickRequired": false
}

This offer requires the purchase of a $25 membership. It also requires the customer to click on the merchant url in order to redeem the offer:

{
    "minSpendAmount": 25.0,
    "purchaseChannels": ["InStore"],
    "purchaseTypes": [
        "Membership"
    ],
    "merchantUrlLinkClickRequired": true
}