---
title: "Using Fees"
slug: "events-object-using-fees"
updated: 2025-04-03T19:10:16Z
published: 2025-04-03T19:10:16Z
canonical: "docs.blackthorn.io/events-object-using-fees"
---

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

# Using Fees

Limitation

Do not use the Virtual Terminal to process a Transaction that includes Fees (Payment Processing or Tax). Fees are not supported by the Virtual Terminal.

---

IMPORTANT NOTE

The process for using Fees works the same whether you use Event Items or Event Item Sessions. For the examples below, we used Event Items.

## Prerequisite

Before you can add Fees to your Event, you must add the following fields to the Event page layout.

1. Go to the relevant Event record.
2. Click the **Gear** icon.
3. Click **Edit Object**. ![EditObject](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/EditObject.jpg)
4. Click the Page Layouts tab.
5. Click Event Layout.
6. Click the Fields tab.
7. In the Quick Fix box, enter and click “Fee." ![Add Field to Page Layout](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Add%20Field%20to%20Page%20Layout.jpg)
8. Drag and drop the following fields on the page layout.
  - **Payment Processing Fee**
  - **Tax Fee**
  - **Tax Fee Calculation Type**
9. Click **Save**.

## Add a Payment Processing Fee to an Event

1. Go to the Event record.
2. Click the **Pencil** icon next to the **Payment Processing Fee** field.
3. Search for and select an existing Fee, OR click **+ New Fee**.
4. To create a new Fee, fill in the following fields.
  - **Fee Name** (required): IMPORTANT: This field will be displayed on checkout.
  - **Fee Percentage** (required): The value must be between 0 and 100.
  - **Default Fee**: If you check the **Default Fee** box, all newly created Events will use this Fee when processing credit card payments. ![NewFee_PaymentProcessing_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/NewFee_PaymentProcessing_1.png)
5. Click **Save**. ![NewFee_PaymentProcessing_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/NewFee_PaymentProcessing_2.png)
6. Click **Save** on the Event record.
7. Click **Update** to update the Event. ![NewFee_PaymentProcessing_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/NewFee_PaymentProcessing_3.png)

Short-Term Limitation

Displaying the **Fee Name** is only available with Tabbed, Full-width, Simple, and BYO CSS UI. It will be extended to Dynamic UI in a future release. Also, please note that the Fee will not be applied to any other Payment Methods at this time.

### What Your Attendees Will See

In this example, the Event Item’s Ticket **Price** = “200.00,” and the Fee record contains the following information.

- **Fee Name** = “Payment Processing Fee”
- **Type** = “Payment Processing”
- **Fee Percentage** = “2.50”

1. Click the **Event Page URL**.
2. The “Starting from” price is based on the Event Item with the lowest **Price**.
3. Click **Get Tickets**. ![BuyTicket_PaymentProcessing_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/BuyTicket_PaymentProcessing_1.png)
4. Add a Ticket to the cart and click **Checkout**. ![BuyTicket_PaymentProcessing_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/BuyTicket_PaymentProcessing_2.png)
5. Fill in the Attendee details and click **Payment**. ![BuyTicket_PaymentProcessing_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/BuyTicket_PaymentProcessing_3.png)
6. Enter the payment details. In the Summary column, you’ll see the cost breakdown. ![BuyTicket_PaymentProcessing_4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/BuyTicket_PaymentProcessing_4.png)
7. Click **Pay**. ![Event Checkout Complete](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Event%20Checkout%20Complete.png)

Once the credit card processing fee and payment have been processed during checkout, a Line Item will be created for the Fee and related to the Invoice. The Line Item will also be visible on the DocumentLink. ![Buy Ticket_PaymentProcessing_5](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_PaymentProcessing_5.png)

## Add a Tax Fee to an Event

### Calculated at Checkout

1. Go to the Event record.
2. Click the **Pencil** icon next to the **Tax Fee** field.
3. Search for an existing Fee or click **+ New Fee**.
4. To create a new Fee record, complete the following fields.
  - **Fee Name** (required): IMPORTANT: This field will be displayed on checkout.
  - **Default Fee** - If you check the **Default Fee** box, all newly created Events will use this Fee for adding taxes.
  - **Fee Percentage**
  - **Type** = “Tax”
  - **Tax Display Setting** = "Calculated at Checkout" (The tax will not be shown until the final payment screen. Note: Taxes are always displayed separately on the final payment screen.) ![New Fee_Calculated at Checkout_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Calculated%20at%20Checkout_1.png)
5. Click **Save**. ![New Fee_Calculated at Checkout_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Calculated%20at%20Checkout_2.png)
6. Click **Save** to save the changes to your Event.
7. Click **Update** to make sure the changes are published on the Event webpage. ![New Fee_Calculated at Checkout_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Calculated%20at%20Checkout_3.png)

#### What Your Attendee Will See

In this example, the Event Item’s Ticket **Price** = “200.00,” and the Fee record contains the following information.

- **Fee Name** = “Sales Tax”
- **Type** = “Tax”
- **Tax Display Setting** = “Calculated at Checkout”
- **Fee Percentage** = “7.5%”

1. Click the **Event Page URL**.
2. The “Starting from” price is based on the Ticket (Event Item) with the lowest **Price**, plus the tax due.
3. Click **Get Tickets**. ![Buy Ticket_Calculated at Checkout_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Calculated%20at%20Checkout_1.png)
4. Add the General Admission Ticket to the cart and click **Checkout**. ![Buy Ticket_Calculated at Checkout_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Calculated%20at%20Checkout_2.png)
5. Enter the Attendee details and click **Payment**. ![Buy Ticket_Calculated at Checkout_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Calculated%20at%20Checkout_3.png)
6. Enter the payment details. In the Order Summary column, you'll see the cost breakdown. ![Buy Ticket_Calculated at Checkout_4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Calculated%20at%20Checkout_4.png)
7. Click **Pay**. ![Event Checkout Complete](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Event%20Checkout%20Complete.png)

Once the tax amount and payment have been processed, a Line Item will be created for the Fee and related to the Invoice. The Line Item will also be visible on the DocumentLink. ![Buy Ticket_Calculated at Checkout_5](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Calculated%20at%20Checkout_5.png)

### Tax-Inclusive Pricing

1. Go to the Event record.
2. Click the **Pencil** icon next to the **Tax Fee** field.
3. Search for an existing Fee or click **+ New Fee**.
4. To create a new Fee record, complete the following fields.
  - **Fee Name** (required): IMPORTANT: This field will be displayed on checkout.
  - **Default Fee** - If you check the **Default Fee** box, all newly created Events will use this Fee for adding taxes.
  - **Fee Percentage**
  - **Type** = “Tax”
  - **Tax Display Setting** = "Tax-Inclusive Pricing" (The advertised price will include tax. Note: Taxes are always displayed separately on the final payment screen.) ![New Fee_Tax Inclusive Pricing_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Tax%20Inclusive%20Pricing_1.png)
5. Click **Save**. ![New Fee_Tax Inclusive Pricing_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Tax%20Inclusive%20Pricing_2.png)
6. Click **Save** to save the changes to your Event.
7. Click **Update** to make sure the changes are published on the Event webpage. ![New Fee_Tax Inclusive Pricing](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Tax%20Inclusive%20Pricing_3.png)

#### What Your Attendee Will See

In this example, the Event Item’s Ticket **Price** = “200.00,” and the Fee record contains the following information.

- **Fee Name** = “State Sales Tax”
- **Type** = “Tax”
- **Tax Display Setting** = “Tax-Inclusive Pricing”
- **Fee Percentage** = “3.5%”

1. Click the **Event Page URL**.
2. The “Starting from” price is based on the Ticket (Event Item) with the lowest **Price**, plus the tax due.
3. Click **Get Tickets**. ![Buy Ticket_Tax Inclusive Pricing_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Tax%20Inclusive%20Pricing_1.png)
4. Add the General Admission Ticket to the cart and click **Checkout**. ![Buy Ticket_Tax Inclusive Pricing_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Tax%20Inclusive%20Pricing_2.png)
5. Enter the Attendee details and click **Payment**. ![Buy Ticket_Tax Inclusive Pricing_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Tax%20Inclusive%20Pricing_3.png)
6. Enter the payment details. In the Order Summary column, you'll see the cost breakdown. ![Buy Ticket_Tax Inclusive Pricing_4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Tax%20Inclusive%20Pricing_4.png)
7. Click **Pay**. ![Event Checkout Complete](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Event%20Checkout%20Complete.png)

Once the tax amount and payment have been processed, a Line Item will be created for the Fee and related to the Invoice. The Line Item will also be visible on the DocumentLink. ![Buy Ticket_Tax Inclusive Pricing_5](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Ticket_Tax%20Inclusive%20Pricing_5.png)

## Tax-Exempt Event Items

In the following examples, you will see an Event with two Event Items, but one of the Event Items is tax-exempt.

### Tax - Calculated at Checkout

Create an Event with two Event Items, but one of the Event Items is tax-exempt.

1. Go to the Event record.
2. Click the **Pencil** icon next to the **Tax Fee** field.
3. Search for an existing Fee or click **+ New Fee**.
4. To create a new Fee record, complete the following fields.
  - **Fee Name** (required): IMPORTANT: This field will be displayed on checkout.
  - **Fee Percentage**
  - **Default Fee** - If you check the **Default Fee** box, all newly created Events will use this Fee for adding taxes.
  - **Type** = “Tax”
  - **Tax Display Setting** - "Calculated at Checkout" (The tax will not be shown until the final payment screen. Note: Taxes are always displayed separately on the final payment screen.) ![New Fee_Calculated at Checkout_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Calculated%20at%20Checkout_1.png)
5. Click **Save**. ![New Fee_Calculated at Checkout_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Calculated%20at%20Checkout_2.png)
6. Click **Save** to save the changes to your Event.
7. Click **Update** to make sure the changes are published on the Event webpage. ![New Fee_Calculated at Checkout_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Calculated%20at%20Checkout_3.png)

#### What Your Attendees Will See

In this example, the first Event Item’s Ticket **Price** = “200.00,” the second tax-exempt Event Item’s **Price** = “100.00,” and the Fee record contains the following information.

- **Fee Name** = “Sales Tax”
- **Type** = “Tax”
- **Tax Display Setting** = “Calculated at Checkout”
- **Fee Percentage** = “7.50%”

1. Click the **Event Page URL**.
2. The “Starting from” price is based on the Event Item with the lowest Price.
3. Click **Get Tickets**. ![Buy Exempt Ticket_CaC_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Exempt%20Ticket_CaC_1.png)
4. Add the General Admissions Ticket to the cart and click **Checkout**. ![Buy Exempt Ticket_CaC_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Exempt%20Ticket_CaC_2.png)
5. Fill in the Attendee details and click **Payment**. ![Buy Exempt Ticket_CaC_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Exempt%20Ticket_CaC_3.png)
6. Enter the payment details. In the Summary column, you’ll see the cost breakdown. ![Buy Exempt Ticket_CaC_4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Exempt%20Ticket_CaC_4.png)
7. Click **Pay**. ![Event Checkout Complete](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Event%20Checkout%20Complete.png)

Once the credit card processing fee and payment have been processed during checkout, a Line Item will be created for the Fee and related to the Invoice. The Line Item will also be visible on the DocumentLink. ![Buy Exempt Ticket_CaC_5](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Exempt%20Ticket_CaC_5.png)

### Tax - Tax-inclusive Pricing

Create an Event with two Event Items, but one of the Event Items is tax-exempt.

1. Go to the Event record.
2. Click the **Pencil** icon next to the **Tax Fee** field.
3. Search for an existing Fee or click **+ New Fee**.
4. To create a new Fee record, complete the following fields.
  - **Fee Name** (required): IMPORTANT: This field will be displayed on checkout.
  - **Default Fee** - If you check the **Default Fee** box, all newly created Events will use this Fee for adding taxes.
  - **Fee Percentage**
  - **Type** = “Tax”
  - **Tax Display Setting** = "Tax-Inclusive Pricing" (The advertised price will include tax. Note: Taxes are always displayed separately on the final payment screen.) ![New Fee_Tax Inclusive Pricing_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Tax%20Inclusive%20Pricing_1.png)
5. Click **Save**. ![New Fee_Tax Inclusive Pricing_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Tax%20Inclusive%20Pricing_2.png)
6. Click **Save** to save the changes to your Event.
7. Click **Update** to make sure the changes are published on the Event webpage. ![New Fee_Tax Inclusive Pricing](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/New%20Fee_Tax%20Inclusive%20Pricing_3.png)

#### What Your Attendees Will See

In this example, the first Event Item’s Ticket **Price** = “200.00,” the second tax-exempt Event Item’s **Price** = “100.00,” and the Fee record contains the following information.

- **Fee Name** = “State Sales Tax”
- **Type** = “Tax”
- **Tax Display Setting** = “Tax-Inclusive Pricing”
- **Fee Percentage** = “3.50%”

1. Click the **Event Page URL**.
2. The “Starting from” price is based on the Event Item with the lowest Price.
3. Click **Get Tickets**. ![Buy Tax Exempt_Tip_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Tax%20Exempt_Tip_1.png)
4. Add the General Admissions Ticket to the cart and click **Checkout**. ![Buy Tax Exempt_Tip_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Tax%20Exempt_Tip_2.png)
5. Fill in the Attendee details and click **Payment**. ![Buy Tax Exempt_Tip_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Tax%20Exempt_Tip_3.png)
6. Enter the payment details. In the Summary column, you’ll see the cost breakdown. ![Buy Tax Exempt_Tip_4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Tax%20Exempt_Tip_4.png)
7. Click **Pay**. ![Event Checkout Complete](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Event%20Checkout%20Complete.png)

Once the credit card processing fee and payment have been processed during checkout, a Line Item will be created for the Fee and related to the Invoice. The Line Item will also be visible on the DocumentLink. ![Buy Tax Exempt_Tip_5](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Buy%20Tax%20Exempt_Tip_5.png)