{"templateId":"markdown","versions":[{"version":"2.0","label":"v2.0","link":"/percents-api/branded-rewards/overview","default":true,"active":true,"folderId":"27d36c3a"}],"sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Branded rewards"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"branded-rewards","__idx":0},"children":["Branded rewards"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Branded rewards give cardholders value they can spend only at the merchant where they earned it, encouraging repeat visits and increased spending. Use the responsibilities below to plan your wallet integration, then follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/branded-rewards/quickstart"},"children":["branded rewards 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/branded-rewards/merchant-activation-eligibility#general-offers"},"children":["general offers"]}," before registration and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/branded-rewards/merchant-activation-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":"code","attributes":{},"children":["ONE_TIME"]}," offers use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/branded-rewards/merchant-activation-eligibility#branded-merchant-activation"},"children":["merchant activation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send purchase data to Percents so qualifying settled purchases can earn merchant value and spend available branded balance. ",{"$$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/branded-rewards/webhooks"},"children":["branded webhooks"]}," to receive earning and spending updates from settlements, update the customer wallet and apply statement credits for branded value spent."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If real-time notifications are a requirement, also send authorizations and use their estimates for early customer feedback. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/reward-lifecycle"},"children":["reward lifecycle"]}," explains estimates and settlement outcomes. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/branded-rewards/reconciliation"},"children":["Purchase lookup"]}," lets you verify a missing result and check the current merchant balance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Earned value may become available later, and remaining value can expire or be clawed back. Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/percents-api/branded-rewards/reward-lifecycle"},"children":["branded lifecycle"]}," to explain when a balance can be spent and why it changes."]}]},"headings":[{"value":"Branded rewards","id":"branded-rewards","depth":1},{"value":"Connect Your Wallet","id":"connect-your-wallet","depth":2}],"frontmatter":{"title":"Branded rewards","description":"Merchant-branded value that encourages spend, frequency and loyalty.","seo":{"title":"Branded rewards"}},"lastModified":"2026-11-10T20:25:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/percents-api/branded-rewards/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}