# Choose a Bayarcash portal key

> Send payments to the right Bayarcash portal by setting a default portal, a portal per form, and portals for each staff member.
>
> Source: https://docs.bcl.my/bayarcash-portal-key/

A portal key tells Bayarcash which of your portals receives a payment. Use separate portals to see which form, payment method or staff member each payment came from. You create and manage portals in the Bayarcash Console ([Bayarcash guide to portals](https://docs.bayarcash.com/430)).

Portal keys only apply to live payments. In **Test Mode**, all payments go to the Bayarcash sandbox. The **Portal Key** field stays locked until you connect your Bayarcash account.

## Set your default portal

The default portal receives every payment that has no portal of its own. To set it:

1. Go to **Platform Setup** → **Payment**.
2. In **Default Portal**, choose a portal.
3. Leave **Require staff to select a portal key** on if staff must choose a portal on every form. Turn it off to let them use the default. It is on until you change it.

   *(Screenshot: The Default Portal field set to a portal, and the Require staff to select a portal key switch, both highlighted)*

4. Click **Save Configuration**. If your keys were saved before, BCL first asks for a one-time code that it sends by email or SMS.

**Default Portal** shows only when **Test Mode** is off and your Bayarcash keys are verified. Only the account owner can change these settings. See [Connect your Bayarcash account](/connect-bayarcash/).

## Pick a portal for one form

To send one form's payments to a different portal:

1. Open the form and go to the **Payment Details** tab.
2. Under **Payment Configuration**, choose a **Portal Key**. If a portal is not required for you, choose **Use account default** (it shows the name of your default portal) to follow the account default. Click the refresh icon next to the field to reload your portal list.

   *(Screenshot: The Payment Configuration section of a form, with the Portal Key field highlighted)*

3. Choose a **Payment Option**. The list shows only the payment methods that portal offers.
4. Click **Update Form** (or **Add Payment Form** for a new form).

## Pick a portal for a payment link

To create a payment link, go to **Quick Actions** → **Payment Link**. Choose the **Portal Key** before you choose the payment method. See [Create a payment link](/payment-link/).

## Give staff their own portals

You can limit staff with the **Team** role to their own portals:

1. Go to **Team** → **Team Members** and click **Edit** next to the staff member.
2. In **Portal Key**, choose one or more portals. Click **Refresh** if a new portal is missing.
3. In **Require Portal Key**, choose **Required** to track their sales to their own portal. The other option is **Optional - uses the default portal**. The default, **Follow portal setting**, uses the account's **Require staff to select a portal key** setting.

   *(Screenshot: A staff member's Edit window with the Portal Key and Require Portal Key fields highlighted)*

4. Click **Save changes**.

Staff then see only their own portals when they create a form or a payment link. Owners and admins always see every portal.

## Tips

A few habits make portals much easier to work with later:

- **Give each form its own portal.** If you have several forms, create a separate portal in Bayarcash for each one. Then choose that portal in the form's **Portal Key**. Each portal then holds only that form's payments, so your reports and reconciliation are simpler. You can match a Bayarcash settlement to one form, and you do not have to sort mixed payments.
- **Name portals after what they collect for.** For example "Kopi Kampung - Coffee Beans" or "Barista Class". You see the name in BCL's **Portal Key** list. A clear name helps staff to choose the correct portal.
- **Keep the default portal for everything else.** Forms and payment links without their own portal use the **Default Portal**. So every payment goes to a portal while you set up the other portals.

## Common issues

### I created a new portal in Bayarcash, but it is not in the Portal Key list. Why?

BCL keeps a copy of your portal list. Click the refresh icon (Refresh portal list) next to the Portal Key or Default Portal field to load it again.

### If I change the Default Portal, do I have to update every form?

No. Forms that do not pick their own portal always follow the Default Portal, so they switch to the new one immediately.

### Can I track each staff member's sales separately?

Yes. Give each staff member their own portal in Team → Team Members and set Require Portal Key to Required. Their forms and payment links then go to their own portal.