{"templateId":"markdown","versions":[{"version":"2.0","label":"v2.0","link":"/percents-api/merchant-segments","default":true,"active":true,"folderId":"27d36c3a"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Offer Segments and Purchase History"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"offer-segments-and-purchase-history","__idx":0},"children":["Offer Segments and Purchase History"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Segmented offers use purchase history to match cardholders to the appropriate merchant offer. Use the guidance below to understand when backfilling is needed and how offers are selected when history is missing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"purchase-history-for-onboarding","__idx":1},"children":["Purchase history for onboarding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Coordinate with Percents to backfill purchase history. Backfilling is needed only for segmented offers, to ensure customers are segmented accurately. Unsegmented offers do not require it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Backfilled history supports offer selection. It does not create rewards or change previous rewards. Do not submit historical purchases as new earning events."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-purchase-history-is-missing","__idx":2},"children":["When Purchase History Is Missing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Missing history is not the same as knowing a customer has made no purchases. Depending on Percents and merchant policy, a cardholder without enough history may:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Receive an unsegmented offer, if one is available."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remain unsegmented with no matching offer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Be assigned to a segment selected under that policy."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As new purchases are recorded, later eligibility requests can use that history. Display the returned offer and terms. Do not infer a customer’s purchase history from a fallback or assume an offer will always match."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understand-the-selection-result","__idx":3},"children":["Understand the Selection Result"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Where returned, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segmentSource"]}," explains how the offer was selected:"]},{"$$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":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Basis for selection"},"children":["Basis for selection"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["history"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purchase history."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unknownDefault"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A fallback under Percents and merchant policy because history was insufficient."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unsegmented"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An offer that does not depend on history."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An evaluation error is not a no-match result or a successful fallback. Follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/standards/errors"},"children":["error and retry guidance"]}," when evaluation fails."]}]},"headings":[{"value":"Offer Segments and Purchase History","id":"offer-segments-and-purchase-history","depth":1},{"value":"Purchase history for onboarding","id":"purchase-history-for-onboarding","depth":2},{"value":"When Purchase History Is Missing","id":"when-purchase-history-is-missing","depth":2},{"value":"Understand the Selection Result","id":"understand-the-selection-result","depth":2}],"frontmatter":{"title":"Offer Segments and Purchase History","description":"Backfill history for segmented offers and understand matching when history is missing.","seo":{"title":"Offer Segments and Purchase History"}},"lastModified":"2026-11-10T20:25:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/percents-api/merchant-segments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}