Percents provides industry-standard card linked offer (CLO) cashback and branded rewards to help increase cardholder spending and purchase frequency at merchants they love. Both products use the same integration foundations: issuer credentials, cardholder accounts, offers, purchase data and reward notifications. Follow the steps below to plan those connections, then use the product quickstarts for implementation.
API authentication is required for these steps.
Register cardholders in either of two ways:
- In advance, before their first activity or purchase.
- Lazily, when Percents first receives activity or purchase data for a new external cardholder ID.
Purchase requests can also create missing cards. Existing accounts are reused.
A cardholder group holds rewards for one cardholder or several cardholders who share an account. Each card belongs to one cardholder. Use your internal IDs on purchase requests and save the returned Percents ID mappings to connect reward results to your customers.
Show general offers before accounts exist. Once you have a cardholder group, request targeted offers for that customer. Display the returned rate and terms.
Send user activity to activate offers. Report observed clicks and views, including for PASSIVE offers. Percents uses that activity to determine activation.
The branded SDK reports activity on behalf of the active cardholder. Send activity yourself for experiences you build outside the SDK.
| Policy | What your integration records |
|---|---|
CLICK | A real cardholder click. |
VIEW | A click or qualifying visibility. |
PASSIVE | No activation. Report observed views and clicks for engagement measurement. |
ONE_TIME (branded only) | Merchant activation. |
Some CLICK and VIEW offers require activation again after one or more rewarded purchases. Others remain activated for the offer’s lifetime. See user activity for activation scope, timing and redemption limits. Branded ONE_TIME offers use merchant activation instead.
Send authorizations if real-time notifications and updates are a requirement. They let you give cardholders early feedback based on the authorization amount, including estimated earnings and tentative spending (branded only).
The settlement amount may differ, so use the settlement result for the actual reward. Percents sends no authorization webhook if the authorization arrives or is processed after settlement.
Send settled purchases, refunds and disputes with your cardholder, card and transaction details. Purchase requests do not take an offer ID. Percents identifies the merchant from purchase data and checks the offer's dates, activation requirement and terms.
Settlement determines the awarded reward and actual spending (branded only). For cashback fraud or abuse, Percents coordinates recovery directly with your institution.
Webhooks report qualified earnings and spending (branded only). With authorization request streaming, use them for real-time cardholder notifications. Use settled spending outcomes to update account state, such as applying a statement credit for branded value spent.
Follow the cashback rewards quickstart to authenticate, connect your purchase feed and receive earned cashback.
Follow the branded rewards quickstart to add merchant balances, earning and spending to your wallet. The optional branded SDK quickstart shows how to add ready-made offer and wallet components.