Credit Rewards
Use the Credit Rewards API endpoints to configure rewards earning, view points balances and transactions, and redeem points against a customer's line of credit account.
ImportantCertain Credit API endpoints are in a draft status and are subject to change without notice. Thredd may modify interfaces, behaviour, and documentation as development continues.
The Thredd Credit platform supports a points-based rewards proposition that can be integrated into your credit programme. Two delivery models are available depending on your configuration. Work with your Thredd account manager to determine which model applies to your programme before building your integration.
NoteFor more information about the Credit API, see: Credit Service API Overview.
Rewards Delivery Models
Option 1: LoanPro-Managed Rewards (LP Accumulation)
In this model, earn rate logic is configured at the product level within the loan management system (LoanPro). Points accumulate within LoanPro and redemption is applied as a credit to the line of credit account. Thredd surfaces the rewards balance through the Credit API, and your interface can display this information alongside account balances and payment details.
Option 2: Thredd-Managed Rewards
In this model, Thredd owns and manages the rewards programme end-to-end, including earn calculation, balance tracking, period limits, redemption processing, and reporting. The rewards engine operates as a separate capability above LoanPro, giving clients more flexibility in how rewards are configured, viewed, and serviced.
This model supports more advanced configuration including MCC-based bonus rates, periodic earn limits, on-demand redemption via API, and Console-based servicing by your operations team.
ImportantThredd-managed rewards is currently in development. Confirm availability with your Thredd account manager before planning your integration.
Rewards Endpoints
The following endpoints are available for both delivery models unless otherwise stated.
| Endpoint | Description | Method |
|---|---|---|
| Get Rewards Balance | Retrieve a customer's unredeemed points balance and its value as a statement credit. | GET |
| Redeem Points | Redeem part of a customer's points balance as a statement credit on their line of credit account. | POST |
| Adjust Rewards Points | Increase or decrease the points balance on a customer account, for example to award goodwill points or correct an error. | POST |
All Rewards endpoints require a Thredd account_id as a path parameter. This is the unique identifier of the line of credit account, returned when a credit application is approved. You should store this value and associate it with the relevant customer in your own system.
How Rewards Work
Earning Points
Option 1: LoanPro-Managed
Points are earned automatically on qualifying purchase transactions posted to the purchase bucket of a customer's line of credit account. The earn rate is configured at the product level when the account is created. A base earn rate — for example, 1% on all purchases — is applied by the loan management system at the point a transaction settles.
Additional earn rate rules can be configured to support:
- MCC-based bonus rates — specific merchant category codes earn at a higher rate
- Merchant-specific rates — individual merchants earn at a bespoke rate based on merchant ID
- Introductory multipliers — a points multiple applied for a defined period from the account open date
Merchant refunds reverse the points accrued at the same rate applied on the original transaction. Other credits to the account, such as payments or adjustments, do not affect the points balance. To change the points balance directly, use the Adjust Rewards Points endpoint.
Option 2: Thredd-Managed
Points are earned on settled purchase transactions received from the card scheme on clearing files. Real-time authorisations are not assessed for rewards. Earn is calculated based on the following configuration, which is defined at the rewards programme level and can be associated with one or more financial products:
- Base earn rate — a percentage applied to all qualifying transactions (for example, 1.00%)
- MCC bonus rate — a delta rate applied on top of the base earn rate for specific merchant category codes (for example, +2.00% delta giving 3.00% overall)
- MCC exclusions — specific merchant category codes that do not earn rewards
- Cash transaction handling — cash transactions can be configured to earn or not earn rewards
- Billing amount limits — a lower and upper transaction value between which a transaction must fall to earn points (for example, between $1.00 and $500.00)
- Maximum points per transaction — a cap on the points earned from a single transaction
- Period earn limits — a maximum points value per statement period or annual period (measured from account open date), or both
Points are earned at the base rate for all qualifying transactions and at the delta rate for transactions with a qualifying MCC. Where a transaction's calculated points exceed the per-transaction maximum, the points are reduced to the maximum value. Where a period limit has already been reached, points are not earned. Where a transaction would partially breach the period limit, only the remaining allowance is earned.
Merchant refunds generate a negative earn value calculated using the configuration in place at the time the refund is received, reducing both the current points balance and the relevant period balance. Chargebacks and disputes do not affect the rewards balance.
Points continue to accrue on accounts regardless of account status.
Viewing Points Earned per Transaction
The Get Account Transactions and Get Transaction Details endpoints return the net reward points for each transaction in the following fields. Use them to show customers how many points each purchase earned, and the points used by each redemption.
| Attribute | Description |
|---|---|
rewardPoints | number or null. The net reward points for the transaction. Positive when points are earned, and negative when points are redeemed or clawed back, for example after a merchant return. |
rewardDollarValue | string or null. The net reward points for the transaction, converted to a dollar value. |
creditCategory | string or null. The credit category of a credit transaction, such as a rewards redemption. Only returned for credit transactions. |
To show only the transactions that earned or redeemed points, set the rewardType query parameter to earned or redeemed. When you filter by rewardType, the reward fields count only the earned or redeemed points, without reversals, so they can differ from the net values returned without the filter.
Redemption
Option 1: LoanPro-Managed
Points are redeemed on demand with the Redeem Points endpoint. You specify the amount of statement credit to apply, and Thredd applies it to the line of credit account at the point of the redemption request and deducts the equivalent points. To check how much credit a customer can redeem, use the rewardValue returned by Get Rewards Balance.
Statement credit is currently the only supported redemption method. Automatic redemption is not supported.
Option 2: Thredd-Managed
Clients can configure one of the following redemption modes at the rewards programme level:
- On-demand redemption — points are redeemed only when triggered by a client API call
- Automatic full redemption per statement period — points redeem automatically in full at the end of each statement period
- Automatic full redemption on annual anniversary — points redeem in full on the 12-month anniversary of when they started accruing
Redemptions reduce the current points balance but do not affect the period earn balances. A redemption request that exceeds the available points balance is rejected.
Webhooks and Reporting
Option 1: LoanPro-Managed
Rewards Balance Change Events
A webhook event is sent each time a customer's points balance changes. The event includes:
- The rewards balance before the change
- The rewards transaction amount (debit or credit)
- The rewards balance after the change
End-of-Day Files
Two end-of-day files are available:
- Outstanding rewards balances — a daily file containing each account's end-of-day rewards balance, including the line of credit ID, account UUID, and financial product ID
- Rewards transactions — a daily file listing all rewards transactions generated since the previous end of day, including points debits and credits per account
Option 2: Thredd-Managed
Daily reporting is available through Thredd.AI and includes:
- Liability summary — current points balance per account
- Daily earned transactions — transactions that generated points
- Daily non-earning transactions — transactions assessed but not qualifying for points
- Daily redeemed totals — redemptions by account
Clients can also view and manage rewards through Thredd Console, where agents with the appropriate access can view points history, redeem points, view period balances, and reset period balances.
Swipe Data
To support rewards earn rate calculation, all card transaction data sent to the loan management system includes the following fields:
- Ecommerce flag — indicates whether the transaction was made online
- Merchant ID — the unique identifier of the merchant
- MCC — the merchant category code classifying the type of business
These fields enable the correct earn rate to be applied based on configured rules.
Updated 7 days ago
