Android Reward Currency

Currency Configuration

Property	Type	Description
rewardCurrencyName	String	Display name for your in-app currency (e.g., "Points", "Coins"). Default: "Points"
rewardPayoutPercentage	Double	Percentage of reward value to display. Default: 100.0
rewardIcon	ActivationIcon?	Icon displayed next to reward amounts. Set to null to show the SDK default reward icon. Configured via Activation.theme — see below.

ActivationClient.instance.apply {
    rewardCurrencyName = "Coins"     // Default: "Points"
    rewardPayoutPercentage = 50.0    // Default: 100.0
}
// The reward icon is part of the theme — set it once on Activation.theme.
Activation.theme = ActivationTheme(
    icons = ActivationTheme.Icons(
        rewardIcon = ActivationIcon.Bytes(iconBytes),
    ),
)

Difference from iOS

The iOS SDK exposes rewardCurrencyPerDollar (a conversion rate, e.g. 100.0 means 100 points = $1), while the Android SDK exposes rewardPayoutPercentage (a percentage of the reward value to display). These properties serve similar purposes but use different units. Reward calculation parity across platforms is being addressed and will be aligned in a future SDK release. Contact your Actual account team for current guidance on configuring reward display for your use case.