Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Get started with Connect
Integration fundamentals
Example integrations
Onboard accounts
Configure account Dashboards
    Get started with Connect embedded components
    Customize Connect embedded components
    Supported Connect embedded components
    Stripe Dashboard customization
    Platform controls for Stripe Dashboard accounts
    Express Dashboard
      Integrate the Express Dashboard
      Customize the Express Dashboard
      Payments features
Accept payments
Pay out to accounts
Manage your Connect platform
Tax forms for your Connect platform
Work with connected account types
HomePlatforms and marketplacesConfigure account DashboardsExpress Dashboard

Customize the Express Dashboard

Learn how to customize the Express Dashboard for your users.

Copy page

The Express Dashboard allows a platform’s connected account users to view their available balance, see upcoming payouts, and track their earnings in real time. It displays an Activity feed, an Earnings chart, and your platform’s name and icon. Learn how to customize the Express Dashboard for your users in this guide.

To learn more about each feature in the Express Dashboard, see Express Dashboard.

Add your platform's brand name and icon

You can display your platform’s brand name, icon, and customize theming in the Express Dashboard.

Access your Express branding settings, enter your platform’s business_name, upload your platform’s icon, and customize your theming settings. When satisfied with the preview, save your changes. If you already saved your brand information before reading this guide, skip this step.

Customize features

You can configure the Express Dashboard features available to your connected accounts by using the Express features settings.

If you turn off a feature in your Express Dashboard settings, your connected accounts don’t see it in the Express Dashboard. Before you go live, we recommend configuring your Express Dashboard settings in a testing environment and previewing them with a test connected account.

Set custom descriptions for charges and transfers

By default, the Transactions list on the Express Dashboard displays generic descriptions for charges and transfers (for example: Payment on {YOUR_PLATFORM}).

First, determine which type of charge your platform uses. The two recommended charge types for Express connected accounts are Destination Charges and Separate Charges and Transfers.

After you determine the charge type, use the following instructions to update your integration.

Destination charges

To update the description on a payment object that’s visible to your platform’s users, you need to use the Stripe API. This applies to all platforms that use destination charges.

  1. Find the existing transfer object you created for an account by finding the latest charge created on the PaymentIntent.
  2. Use the charge object to find the transfer object associated with the charge.
  3. Use the transfer object to find the destination_payment ID that exists on the transfer.
  4. Call the Update Charge API to update the description on the destination payment using the destination_payment ID.

Note

The destination_payment object belongs to the connected account, so you’ll need to set the Stripe-Account header to the connected account’s ID to make this call.

Command Line
cURL
curl https://api.stripe.com/v1/charges/
{{PAYMENT_ID}}
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d description="My custom description"

This description becomes visible on the charge after you’ve written this field.

Learn more about creating destination charges on your platform.

Separate charges and transfers

To update the description on a payment object that’s visible to your platform’s users, you need to use the Stripe API. This applies to platforms that use separate charges and transfers.

  1. Use the transfer object to find the destination_payment ID that exists on the transfer.
  2. Call the Update Charge API to update the description on the destination payment using the destination_payment ID found in the previous step.

Note

The destination_payment object belongs to the connected account, so you’ll need to set the Stripe-Account header to the connected account’s ID to make this call.

Command Line
cURL
curl https://api.stripe.com/v1/charges/
{{PAYMENT_ID}}
\ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d description="My custom description"

This description becomes visible on the charge after you’ve written this field.

Learn more about creating separate charges and transfers.

See also

  • Collect payments and then pay out (if you process payments with Stripe)
  • Pay out money (if you add money from a bank account to pay out)
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc