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 branded rewards quickstart for the API calls and examples.
Your integration should:
- Present offers and their terms to cardholders, using general offers before registration and targeted offers once a cardholder group exists.
- Send all observed Percents-specific offer activity, including clicks and views, through the 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.
ONE_TIMEoffers use merchant activation. - Send purchase data to Percents so qualifying settled purchases can earn merchant value and spend available branded balance. Register cardholder accounts in advance or let supported activity and purchase requests create missing accounts.
- Listen for branded webhooks to receive earning and spending updates from settlements, update the customer wallet and apply statement credits for branded value spent.
If real-time notifications are a requirement, also send authorizations and use their estimates for early customer feedback. The reward lifecycle explains estimates and settlement outcomes. Purchase lookup lets you verify a missing result and check the current merchant balance.
Earned value may become available later, and remaining value can expire or be clawed back. Use the branded lifecycle to explain when a balance can be spent and why it changes.