Cardholders need to see the rate, terms and required action before choosing an offer. Use general offers before registration, targeted offers for a registered cardholder group and eligibility checks to show whether activation or a redemption limit affects earning.
General offers provide broadly available baseline terms. Once registration or lazy provisioning gives you a cardholder group ID, use targeted offers to show the same or better terms for that customer.
Read GET /api/v2/offers and select rewardProductType: cashback. The catalog includes live and scheduled offers before a cardholder group exists. Scheduled offers cannot qualify purchases before their start time. The Offers guide explains pagination.
A cashback offer includes its current terms and structured calculation fields:
{
"id": "mpo_66666666-6666-4666-8666-666666666666",
"rewardProductType": "cashback",
"displayName": "5% cashback",
"description": "Earn cashback on eligible purchases.",
"termsAndConditionsText": "Earn 5% cashback. Eligible purchases must not exceed $100. Rewards are capped at $4 per purchase.",
"merchantId": "mp_55555555-5555-4555-8555-555555555555",
"activationType": "CLICK",
"activationScope": null,
"startAt": "2026-07-01T00:00:00.000Z",
"endAt": null,
"currency": "usd",
"cardholderEarnRate": {
"kind": "basis_points",
"basisPoints": 500
},
"minSpendAmountMinor": null,
"maxTransactionAmountMinor": 10000,
"maxEarnAmountMinor": 400,
"spatialConstraint": "online_and_offline",
"maxRedemptionsPerGroup": null
}Read a particular definition directly through GET /api/v2/offer/{offerId}. Only the offer ID is required. The request does not evaluate the cardholder group.
Once registration or lazy provisioning creates the cardholder group, GET /api/v2/chg/{chgId}/offers returns targeted offers for it. These can include offers omitted from general discovery, with the same or better terms for that customer than the general baseline. For one merchant's live offers and activation state, call:
GET <env-host>/api/v2/chg/{chgId}/merchant/{merchantId}/eligibility?scope=cashbackThe required scope=cashback selects cashback. Each returned offer includes its current chgQualified status and whether activation is recorded. The eligibility response explains those fields and next actions. Qualification for an offer does not approve a transaction. Purchase amount, time, location and redemption limits still apply.
| Policy | Required activity |
|---|---|
PASSIVE | No activation. Report observed views and clicks for engagement measurement. Earning does not depend on that activity. |
CLICK | A recorded click. |
VIEW | A click or qualifying matched viewport entry and exit events. |
The activity guide defines the required events. Its timing rules explain when activation begins and how long it lasts.
activationScope controls how many redemptions each activation covers. maxRedemptionsPerGroup limits total redemptions, independently of reactivation. Offer dates still apply.
- An authorization without a settlement does not count toward the redemption limit.
- A settled purchase that earns a reward counts toward
maxRedemptionsPerGroup. - The limit applies across all cardholders in the cardholder group.
Show the offer's rate and termsAndConditionsText. Percents checks which offer applies to the cardholder group.
The example has two separate limits:
- The purchase must be $100 or less.
- The reward cannot exceed $4.
Use money, dates and limits to format these values. The purchase history guide explains how history supports customer-specific offers.
Once the customer has completed any required activation, submit the purchase as described in the reward lifecycle.
Use the eligibility lookup across merchants with scope=cashback to check cashback offers across all merchants for a cardholder group in one call.