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

# Configuring the Business Unit's Portal Checkout URL

> Set the Portal URL and Portal Checkout Page Path on a Business Unit so fusionCore can build the checkout link for each of its Orders.

The checkout page itself is a standard Experience Cloud page that loads an Order from a `?orderId=<Order UUID>` URL parameter. There is no checkout-page lookup field on the Business Unit. Instead, the Business Unit stores two pieces of the checkout URL, and fusionCore combines them with the Order's UUID to build the full link that is stored on each Order in **Portal Checkout URL** (`FCORE_PORTAL__Portal_Checkout_URL__c`).

The two fields you configure on the Business Unit are:

* **Portal URL** (`FCORE_PORTAL__Portal_URL__c`) — the base URL of your Experience Cloud site.
* **Portal Checkout Page Path** (`FCORE_PORTAL__Portal_Checkout_Page_Path__c`) — the path of the page on that site where you placed the checkout components.

## Prerequisites

* An Experience Cloud site with a published checkout page. See [Checkout (LWC) Overview](/end-user-guides/portal/checkout-lwc/index).
* Access to the Business Unit record you want to configure.

## How to Configure the Business Unit

<Steps>
  <Step title="Copy your portal's URL">
    In **Setup**, type **All Sites** in the Quick Find box and select it. Copy the URL of your portal site.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/PQhCyVfBbt1uWfmh/images/end-user-guides/4861755449/Screenshot_2025-02-05_at_8.15.01-PM.png?fit=max&auto=format&n=PQhCyVfBbt1uWfmh&q=85&s=5910bac571e15ff714073228746135df" alt="The All Sites page in Setup showing the portal site URL" width="2376" height="1214" data-path="images/end-user-guides/4861755449/Screenshot_2025-02-05_at_8.15.01-PM.png" />
    </Frame>
  </Step>

  <Step title="Paste the URL into the Business Unit">
    Open the **Business Unit** you want to set up. Paste the URL you copied into the **Portal URL** (`FCORE_PORTAL__Portal_URL__c`) field.

    <Frame caption="Setting the Portal URL on the Business Unit">
      <img src="https://mintcdn.com/fusionspan/PQhCyVfBbt1uWfmh/images/end-user-guides/4861755449/image-20260318-182726.png?fit=max&auto=format&n=PQhCyVfBbt1uWfmh&q=85&s=2fdc91f6df358a93ea309bb44040ff9d" alt="The Portal URL field on a Business Unit record" width="932" height="679" data-path="images/end-user-guides/4861755449/image-20260318-182726.png" />
    </Frame>
  </Step>

  <Step title="Set the checkout page path">
    Copy the path of the page where you placed the checkout components, then paste it into the **Portal Checkout Page Path** (`FCORE_PORTAL__Portal_Checkout_Page_Path__c`) field. Click **Save**.

    <Frame>
      <img src="https://mintcdn.com/fusionspan/PQhCyVfBbt1uWfmh/images/end-user-guides/4861755449/Screenshot_2025-02-05_at_8.20.18-PM.png?fit=max&auto=format&n=PQhCyVfBbt1uWfmh&q=85&s=510b04f9d36279e64522b063e5d2bec9" alt="The Portal Checkout Page Path field on a Business Unit record" width="1454" height="1548" data-path="images/end-user-guides/4861755449/Screenshot_2025-02-05_at_8.20.18-PM.png" />
    </Frame>
  </Step>
</Steps>

With both fields set, fusionCore populates **Portal Checkout URL** (`FCORE_PORTAL__Portal_Checkout_URL__c`) on Orders belonging to that Business Unit, appending each Order's UUID as the `orderId` parameter so the link opens the correct Order at checkout.

## Limitations and Common Pitfalls

* **Both fields must be set, or the checkout link is incomplete.** If either **Portal URL** or **Portal Checkout Page Path** is blank, the generated checkout URL will not resolve to a working page. Set both before sending Orders to the Portal.
* **The path must match your published checkout page.** If the **Portal Checkout Page Path** does not match the actual page path on your site, the link opens the wrong page (or none). Copy the path directly from the published page rather than typing it.
* **Each Business Unit is configured separately.** These fields live on the Business Unit, so a multi–Business Unit org needs each Business Unit's URL and path set individually.