# Financial account rewards

Show reward earnings for a connected account's financial account.

The financial account rewards component shows connected accounts the lifetime rewards, current-month accrual, next payout date, annual reward rate, and monthly payout history for a financial account. To learn about eligibility and configure rewards, see [Platform cash rewards](https://docs.stripe.com/treasury/connect/legacy/v1/cash-rewards.md).

The component is in private preview and requires `@stripe/connect-js` version `3.4.8-preview.0` or later, or `@stripe/react-connect-js` version `3.4.8-preview.0` or later. Learn more about [private preview components](https://docs.stripe.com/connect/supported-embedded-components.md#preview-components).

## Create an Account Session 

First, [set up Connect embedded components](https://docs.stripe.com/connect/get-started-connect-embedded-components.md). When you create an [Account Session](https://docs.stripe.com/api/account_sessions.md), enable the Financial account rewards component by setting `components.financial_account_rewards.enabled` to `true`.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-08-26.preview" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[financial_account_rewards][enabled]=true"
```

## Render the component 

#### HTML + JS

```js
const financialAccountRewards = stripeConnectInstance.create('financial-account-rewards');
financialAccountRewards.setFinancialAccount("{{FINANCIAL_ACCOUNT_ID}}");
// Add the component to an existing element on your page.
container.appendChild(financialAccountRewards);
```

#### React

```jsx
import {
  ConnectComponentsProvider,
  ConnectFinancialAccountRewards,
} from '@stripe/react-connect-js';

const FinancialAccountRewards = () => {
  return (
    <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
      <ConnectFinancialAccountRewards financialAccount="{{FINANCIAL_ACCOUNT_ID}}" />
    </ConnectComponentsProvider>
  );
};
```

### Supported parameters 

This embedded component supports the following parameter:

#### HTML + JS

| Method | Type | Description |  |
| --- | --- | --- | --- |
| `setFinancialAccount` | `string` | The ID of the financial account to display rewards for. | required |

#### React

| React prop | Type | Description |  |
| --- | --- | --- | --- |
| `financialAccount` | `string` | The ID of the financial account to display rewards for. | required |

## Request access 

### Request early access to cash rewards

The cash rewards feature is currently limited to preview users. Enter your email address to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/connect/supported-embedded-components/financial-account-rewards" \
  -d '{"email": "EMAIL", "preview": "cash_rewards_preview"}'
```