{"templateId":"markdown","versions":[{"version":"2.0","label":"v2.0","link":"/percents-api/cashback/offers-and-eligibility","default":true,"active":true,"folderId":"27d36c3a"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cashback offers and eligibility"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cashback-offers-and-eligibility","__idx":0},"children":["Cashback offers and eligibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"general-offers","__idx":1},"children":["General offers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api#operation/listIssuerOffers"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/offers"]}]}," and select ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rewardProductType: cashback"]},". The catalog includes live and scheduled offers before a cardholder group exists. Scheduled offers cannot qualify purchases before their start time. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/offers#general-offers"},"children":["Offers guide"]}," explains pagination."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A cashback offer includes its current terms and structured calculation fields:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"mpo_66666666-6666-4666-8666-666666666666\",\n  \"rewardProductType\": \"cashback\",\n  \"displayName\": \"5% cashback\",\n  \"description\": \"Earn cashback on eligible purchases.\",\n  \"termsAndConditionsText\": \"Earn 5% cashback. Eligible purchases must not exceed $100. Rewards are capped at $4 per purchase.\",\n  \"merchantId\": \"mp_55555555-5555-4555-8555-555555555555\",\n  \"activationType\": \"CLICK\",\n  \"activationScope\": null,\n  \"startAt\": \"2026-07-01T00:00:00.000Z\",\n  \"endAt\": null,\n  \"currency\": \"usd\",\n  \"cardholderEarnRate\": {\n    \"kind\": \"basis_points\",\n    \"basisPoints\": 500\n  },\n  \"minSpendAmountMinor\": null,\n  \"maxTransactionAmountMinor\": 10000,\n  \"maxEarnAmountMinor\": 400,\n  \"spatialConstraint\": \"online_and_offline\",\n  \"maxRedemptionsPerGroup\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read a particular definition directly through ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api#operation/getOfferDetails"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v2/offer/{offerId}"]}]},". Only the offer ID is required. The request does not evaluate the cardholder group."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"targeted-offers-and-merchant-eligibility","__idx":2},"children":["Targeted offers and merchant eligibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once registration or lazy provisioning creates the cardholder group, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/openapi/percents-api#operation/listAvailableOffers"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET <env-host>/api/v2/chg/{chgId}/merchant/{merchantId}/eligibility?scope=cashback\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The required ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope=cashback"]}," selects cashback. Each returned offer includes its current ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chgQualified"]}," status and whether activation is recorded. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/offers#merchant-eligibility"},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activation-policies","__idx":3},"children":["Activation policies"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Policy"},"children":["Policy"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required activity"},"children":["Required activity"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PASSIVE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No activation. Report observed views and clicks for engagement measurement. Earning does not depend on that activity."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A recorded click."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIEW"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A click or qualifying matched viewport entry and exit events."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/user-activity#activation-policies"},"children":["activity guide"]}," defines the required events. Its ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/user-activity#when-offers-need-to-be-activated-again"},"children":["timing rules"]}," explain when activation begins and how long it lasts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activationScope"]}," controls how many redemptions each activation covers. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxRedemptionsPerGroup"]}," limits total redemptions, independently of reactivation. Offer dates still apply."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An authorization without a settlement does not count toward the redemption limit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A settled purchase that earns a reward counts toward ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxRedemptionsPerGroup"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The limit applies across all cardholders in the cardholder group."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reading-offer-terms","__idx":4},"children":["Reading offer terms"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Show the offer's rate and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["termsAndConditionsText"]},". Percents checks which offer applies to the cardholder group."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The example has two separate limits:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The purchase must be $100 or less."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The reward cannot exceed $4."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/standards/units-and-ids"},"children":["money, dates and limits"]}," to format these values. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/merchant-segments"},"children":["purchase history guide"]}," explains how history supports customer-specific offers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the customer has completed any required activation, submit the purchase as described in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/reward-lifecycle"},"children":["reward lifecycle"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/offers#group-wide-eligibility"},"children":["eligibility lookup across merchants"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope=cashback"]}," to check cashback offers across all merchants for a cardholder group in one call."]}]},"headings":[{"value":"Cashback offers and eligibility","id":"cashback-offers-and-eligibility","depth":1},{"value":"General offers","id":"general-offers","depth":2},{"value":"Targeted offers and merchant eligibility","id":"targeted-offers-and-merchant-eligibility","depth":2},{"value":"Activation policies","id":"activation-policies","depth":2},{"value":"Reading offer terms","id":"reading-offer-terms","depth":2}],"frontmatter":{"title":"Cashback offers and eligibility","description":"Discover cashback offers and check activation and purchase requirements.","seo":{"title":"Cashback offers and eligibility"}},"lastModified":"2026-11-10T20:25:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/percents-api/cashback/offers-and-eligibility","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}