Skip to main content
Use our hosted banking interface, fully branded with your logo and color scheme, to offer a full banking experience that matches your brand without writing a custom UI.
Embedded Widgets

​
Brand assets

You will need to provide us with the following so that the white label site to be branded to your look and feel:
  • Primary Logo
  • Alternative Logo
  • Primary color
  • Font style
  • Font color
  • Hyperlink color
  • Button color
  • Button corner radius
You can upload your organization logo programmatically — see Upload organization logo in the FinOps guide for details on the shared /identity/v1/organizations/{organizationId}/logo endpoint.

​
Initiating the application

You can embed the White label application with as little as a hyperlink from your own software linking to the URL for the site, however for a more seamless presentation, the recommended implementation is below:
  1. Integrate our marketing widget into your dashboard to increase attention on the embedded account
    1. NOTE: You must pass in the data-should-redirect="true" parameter to ensure the widget will redirect users to your white label site
    2. The marketing widget will be automatically hidden once a user from a given business enrolls in the account
  2. Create a Banking menu in your navigation structure that links to the white label application login page

​
Authentication and application lifecycle

The white-label hosted app does not hold a backend bearer token. Your backend creates the bank account application server-to-server, receives a short-lived application client secret in the create response, and hands that secret to the hosted app to authenticate the rest of the flow. If an applicant comes back days later, your backend re-issues a secret through the resume endpoint and the hosted app picks up where the applicant left off. For the full sequence — states, transitions, and which auth method is required at each step — see the application lifecycle guide.

​
Custom domains

You can use Tesouro’s default domain for your white label application (company.business-banking.app), or configure a custom domain by setting up a CNAME record with your DNS provider that points to our domain. This allows your application to appear fully branded and seamless to your end users. To do this, follow these instructions:
  1. Submit a request to Tesouro for custom domain configuration. You’ll need to include the fully-qualified domain name you would like to use. It can only include the subdomain and domain, without any path. For example: banking.myorg.com works, but myorg.com/banking does not.
  2. Tesouro will respond with instructions about specific CNAME DNS record that you will need to configure in your DNS provider within a certain time period. This allows us to configure TLS for routing on our side of things.
  3. Once you have configured the CNAME DNS record that we send you, we will activate your custom domain on our system and notify you when it is ready!