> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout themes — branding your payment pages

> Customize the look and feel of your payment links, invoices, and order form checkouts with branded themes, colors, and logos.

Checkout themes let you apply consistent branding to every payment page your customers see — from standalone payment links to invoice payment portals. Set your logo, colors, and fonts once and apply the theme across all your payment channels so customers always experience a polished, on-brand checkout.

<Note>
  Themes configured here apply to standalone payment links and invoice payment pages. Order forms embedded in funnels and websites inherit the visual styling from the funnel or website builder itself.
</Note>

***

## Where themes are configured

Checkout themes are managed at **Payments → Payment Settings → Checkout Themes** (also labeled as the **Themes** tab depending on your account view). From this screen you can create multiple named themes and apply each one to different payment channels.

***

## Creating a checkout theme

<Steps>
  <Step title="Open the Themes screen">
    Navigate to **Payments → Payment Settings → Checkout Themes** and click **+ New Theme** or **Create Theme**.
  </Step>

  <Step title="Name the theme">
    Give the theme a descriptive name that helps you identify it later — for example, `Main Brand`, `Summer Promo`, or `Enterprise Clients`.
  </Step>

  <Step title="Upload your logo">
    Click the logo upload area and select an image file from your computer. The logo will appear at the top of your payment pages. Use a PNG with a transparent background for the best result on both light and dark backgrounds.
  </Step>

  <Step title="Set the primary color">
    Choose a primary color using the color picker or enter a hex code directly. The primary color is used for buttons, highlighted fields, and accent elements across the checkout page.
  </Step>

  <Step title="Set the background color">
    Choose the background color for the payment page. A light neutral or white background keeps the page readable and professional.
  </Step>

  <Step title="Choose a font family">
    Select from the available font options. Choose a font that matches or complements your brand's typography.
  </Step>

  <Step title="Preview in real time">
    The preview panel on the right updates instantly as you make changes. Review how the logo, colors, and font look together on a sample checkout page before saving.
  </Step>

  <Step title="Save the theme">
    Click **Save**. The theme is now available to apply to payment links and invoices.
  </Step>
</Steps>

<Tip>
  Create multiple themes to support different campaigns or client segments. For example, a default brand theme for everyday transactions and a high-contrast accessible theme for specific audiences.
</Tip>

***

## Applying a theme to a payment link

<Steps>
  <Step title="Open the payment link editor">
    Go to **Payments → Payment Links** and click **+ New Payment Link** to create one, or click the three-dot menu on an existing payment link and select **Edit**.
  </Step>

  <Step title="Locate the Appearance section">
    In the payment link editor, find the **Appearance** section (typically in the sidebar or settings panel on the right side of the editor).
  </Step>

  <Step title="Select a theme">
    Use the theme dropdown to choose the theme you want to apply. The preview updates to show how your payment link will look with that theme.
  </Step>

  <Step title="Save the payment link">
    Click **Save** or **Publish**. The selected theme is now applied to the live payment page for that link.
  </Step>
</Steps>

***

## Applying a theme to invoices

<Steps>
  <Step title="Open invoice settings">
    Go to **Payments → Invoices** and click the **gear icon** to open the invoice settings panel.
  </Step>

  <Step title="Select the default theme">
    In the settings panel, locate the **Theme** or **Payment Page Theme** option and choose the theme you want to use as the default for all invoice payment pages.
  </Step>

  <Step title="Save">
    Click **Save**. All new invoices will use this theme for their customer-facing payment page. Existing invoices already sent to customers will reflect the updated theme immediately.
  </Step>
</Steps>

<Note>
  The checkout theme applies to the online payment page that customers land on when they click the **Pay Now** link in an invoice email. It does not change the appearance of the PDF invoice document itself. PDF invoice branding is configured separately under invoice layout settings.
</Note>

***

## Order forms and funnel checkouts

Order forms built inside the funnel and website builder do not use payment link themes. Instead, they inherit the visual styling of the funnel page they are embedded in — colors, fonts, and background are all controlled through the funnel or website builder's design settings.

For additional payment-specific customization on order forms, use the order form element's own settings within the builder to adjust button colors, field styles, and layout.

***

## Custom terms and conditions on checkout

You can display custom terms and conditions text on your payment link pages, requiring customers to review your policies before completing a purchase.

<Steps>
  <Step title="Open the payment link editor">
    Go to **Payments → Payment Links** and open the payment link you want to add terms to.
  </Step>

  <Step title="Find the terms field">
    Locate the **Terms and Conditions** or **Custom Text** field in the payment link settings.
  </Step>

  <Step title="Enter your terms text">
    Type or paste your terms and conditions. You can include hyperlinks — for example, a link to your full terms of service page — so customers can read the complete document before paying.
  </Step>

  <Step title="Save">
    Click **Save**. The terms text now appears below the **Pay** button on your payment page.
  </Step>
</Steps>

<Tip>
  Link to your hosted terms of service page rather than pasting the entire document. This keeps the checkout page uncluttered while still providing full legal transparency.
</Tip>

***

## Custom redirect URL after payment

Send customers to a specific page after they complete a payment — such as a thank-you page, a course access portal, or an onboarding flow.

<Steps>
  <Step title="Open the payment link editor">
    Go to **Payments → Payment Links** and edit the payment link you want to configure.
  </Step>

  <Step title="Enter the redirect URL">
    Find the **Redirect URL** or **Success URL** field and enter the full URL of the page you want customers to land on after payment.
  </Step>

  <Step title="Save and test">
    Save the payment link. Process a test payment using Stripe's test card numbers to confirm the redirect works correctly before sharing the link with real customers.
  </Step>
</Steps>

<Warning>
  The redirect URL is configured per payment link, not globally. If you have multiple payment links, you need to set the redirect URL on each one individually.
</Warning>

***

## Invoice branding beyond themes

Themes control the online payment page, but additional branding elements apply specifically to the invoice document itself.

### Business logo on invoices

Upload a business logo at **Settings → Business Profile**. This logo appears automatically on all invoices you generate, both in the PDF document and in the email header. No additional configuration is needed once it is uploaded.

### Invoice header colors

Customize the header color band that appears at the top of invoice documents at **Payments → Invoices → Settings → Invoice Layout**. This is separate from the checkout theme and only affects the printed or PDF invoice.

### Custom invoice footer message

Add a custom footer message to invoice emails — such as a thank-you note, your support contact, or a reminder of your payment policy. Configure this in **Payments → Invoices → Settings** under the email template section.

***

## Receipt customization

Payment receipt emails sent after a successful transaction can be customized to match your brand.

<Steps>
  <Step title="Open receipt settings">
    Go to **Payments → Payment Settings → Payment Receipts**.
  </Step>

  <Step title="Customize the receipt">
    Adjust the following elements:

    * **Title** — the subject line or heading of the receipt email
    * **Body text** — a custom message shown in the receipt body (e.g., a thank-you message or next steps)
    * **Logo** — upload a logo to appear at the top of the receipt email
    * **Brand color** — set the accent color used in the receipt email design
  </Step>

  <Step title="Preview and save">
    Use the preview function to see how the receipt email will look to customers, then click **Save**.
  </Step>
</Steps>

<Tip>
  Use the body text field to include a brief message directing customers to their next step — for example, how to access a digital product they purchased or where to go for onboarding support.
</Tip>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I have different themes for different products?">
    Yes. Each payment link has its own theme setting. Create a separate payment link for each product or product group and assign a different theme to each. This lets you run differentiated branding for different offerings, campaigns, or client segments simultaneously.
  </Accordion>

  <Accordion title="Can I remove the HoopAI branding from the checkout?">
    Custom branding options are available on the Enterprise plan. If your plan includes custom branding, you can configure it in **Settings → Business Profile**. Contact support to learn more about branding options on your plan.
  </Accordion>

  <Accordion title="Can I use a custom domain for my payment links?">
    Yes. Connect a custom domain in **Settings → Domains** and assign it to your account. Once connected, payment links will use your custom domain instead of the default platform domain, providing a fully branded URL for your customers.
  </Accordion>

  <Accordion title="Can I add tracking pixels to checkout pages?">
    For order forms embedded in funnels or websites, you can add Facebook Pixel, Google Tag, and other tracking scripts through the funnel or website's tracking settings. For standalone payment links, tracking pixel support is not currently available. Use funnel order forms if conversion tracking is a requirement.
  </Accordion>

  <Accordion title="Can I show a custom image on the payment page?">
    Standalone payment links do not currently support custom images or banners beyond your logo. For full layout control — including product images, hero banners, and custom sections — create a funnel with an order form step. The funnel builder gives you complete design flexibility.
  </Accordion>

  <Accordion title="Can I change the button text on the payment page?">
    Button text customization is not available on standalone payment links. The button defaults to a standard label. For full button text control, use an order form inside the funnel builder, which allows you to set custom button labels and copy.
  </Accordion>

  <Accordion title="Does the checkout theme apply to subscription signup pages?">
    Subscription products can be sold through a payment link that has a theme applied. If you link a subscription product to a payment link, the theme you assign to that payment link will appear on the customer's signup and payment page.
  </Accordion>

  <Accordion title="Can I preview the checkout page before sharing it?">
    Yes. In the payment link editor, use the **Preview** option to open a live preview of how the payment page will appear to customers. You can test the layout, check that your theme looks correct, and verify the product details before publishing the link.
  </Accordion>
</AccordionGroup>