Payment fails because a business unit isn't set up for payment processing

 Troubleshooting
Role: Administrator · Office AdminArea: Payments · Payment Processing · Business Units · All versions

Reason 1

The business unit isn't enabled on your payment processor.

The business unit tied to the invoice has not been added to your credit card or ACH payment processor. ServiceTitan can only process payments for business units that have been added to the processor under Payment Processing, so any business unit left unselected is blocked.

Reason 2

The business unit is inactive.

A deactivated business unit does not appear in the processor's list to be selected, so it cannot process payments until it is reactivated.

Reason 3

The business unit is enabled for one payment method but not the one being used.

For example, it is set up for credit cards but you are attempting an ACH (Bank Accounts) payment.

Before you start

You need access to your Payment Processing settings to make this change. This is an admin-level setting. If you cannot see or edit it, contact your admin.

1Add the business unit to your payment processor

1. On the navigation bar, click Settings > Integrations > Payment Processing.

2. Click Credit Cards or Bank Accounts (ACH), then click Edit on your account. (Choose the option that matches the payment method that is failing.)

3. On the Online Payments Account screen, select the business units that should be enabled for that payment method. Make sure every business unit you take payments for is selected.

4. Click Save to apply the changes.

Note: If the technician is collecting the payment in ServiceTitan Mobile, have them download the pricebook after you save so the change reaches the app.

✓ Done · The affected business unit is now enabled on the payment processor, and payments for that business unit process without the "not set up" error.

2If the business unit isn't in the list, reactivate it first

Use this if the failing business unit doesn't appear in the list on the Online Payments Account screen.

A deactivated business unit produces the same "not set up" error and will not show up under Payment Processing until it is active again.

1. Reactivate the business unit in your business unit settings.

2. Return to Settings > Integrations > Payment Processing and complete Check 1 to add the now-active business unit to the processor.

✓ Next · With the business unit active, follow Check 1 to add it to the payment processor.

If every business unit is active and enabled for the correct payment method and the payment still fails, the cause is likely at the merchant or gateway level rather than business unit setup. Contact ServiceTitan Technical Support at go.servicetitan.com/ask with:

• Your tenant name and the business unit that's failing

• Whether the failing payment is credit card or ACH (Bank Accounts)

• The exact error message you see when the payment fails

• A specific invoice or job where the payment was blocked

• Whether the business unit is active and appears in the Payment Processing list