{"templateId":"markdown","versions":[{"version":"2.0","label":"v2.0","link":"/percents-api/cashback","default":true,"active":true,"folderId":"27d36c3a"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cashback Rewards"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cashback-rewards","__idx":0},"children":["Cashback Rewards"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card linked offers let cardholders earn cashback on qualifying purchases and incentivize additional spend with participating merchants. Use the responsibilities below to plan your wallet integration, then follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cashback/quickstart"},"children":["cashback quickstart"]}," for the API calls and examples."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-your-wallet","__idx":1},"children":["Connect Your Wallet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your integration should:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Present offers and their terms to cardholders, using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cashback/offers-and-eligibility#general-offers"},"children":["general offers"]}," before registration and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cashback/offers-and-eligibility#targeted-offers-and-merchant-eligibility"},"children":["targeted offers"]}," once a cardholder group exists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send all observed Percents-specific offer activity, including clicks and views, through the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/user-activity"},"children":["user activity API"]},". Send activity even for offers that need no activation. Percents uses it to measure engagement and activate offers when the activity qualifies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send purchase data to Percents so qualifying settled purchases can earn cashback. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cardholder-groups"},"children":["Register cardholder accounts"]}," in advance or let supported activity and purchase requests create missing accounts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Listen for ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cashback/webhooks"},"children":["cashback webhooks"]}," to receive earned-reward updates from settlements and show the awarded cashback in your wallet."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If real-time notifications are a requirement, also send authorizations and use their reward estimates for early customer feedback. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/reward-lifecycle"},"children":["reward lifecycle"]}," explains the difference between estimates and awarded rewards. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/cashback/reconciliation"},"children":["Purchase lookup"]}," lets you check a result when a response or notification is missing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send refunds and disputes for fraud and abuse detection. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/transaction-ingestion/settlements#report-refunds-and-disputes"},"children":["cashback recovery"]}," for direct issuer follow-up without routine clawback webhooks."]}]},"headings":[{"value":"Cashback Rewards","id":"cashback-rewards","depth":1},{"value":"Connect Your Wallet","id":"connect-your-wallet","depth":2}],"frontmatter":{"title":"Cashback Rewards","description":"Card-linked offer cashback earned on qualified purchases.","seo":{"title":"Cashback Rewards"}},"lastModified":"2026-11-10T20:25:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/percents-api/cashback","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}