Welcome to XTruLink support

What is BBMS?

With Blackbaud Payment Service (BBPS) and Blackbaud Merchant Services (BBMS), you can securely process credit card transactions through your Blackbaud program. From the Blackbaud website, you can set up accounts with both BBPS and BBMS. When you create your merchant account, it automatically appears in the BBMS web portal and in your Blackbaud programs. After you set up your account, you can configure your account settings and manage transaction processing through the Blackbaud web portal.

Connecting BBMS and XTrulink

XTruLink must access BBMS in order to process payments. You will need to grant us access by following the steps in the article below.

Before Getting Started

The user who completes these steps must be a Blackbaud organization administrator. This is not the same thing as an Altru system administrator. If you are not sure if you have these permissions, see this Blackbaud article for more information.

You must also have an XTruLink account with the Back Office Administrator permission. If you need help with this criteria, please contact us here.

Step 1: Select Dedicated User Account

We highly recommend you create and control a dedicated Blackbaud user account that you will use to complete the BBMS connection. This might be something like: admin@yourdomain.com or xtrulink@yourdomain.com.

Because staff changes are common, we do not recommend completing the connection using an individual’s personal account (i.e. yourname@yourdomain.com). If an individual’s account is used to complete connection, and that account is removed or inactivated in the future, then the BBMS connection will be broken, and we will no longer be able to process payments.

Please create or select your dedicated Blackbaud user account. Then, ensure the account is designated as a Blackbaud organization administrator and login to blackbaud.com using that account.

Step 2: Set Account as Environment Admin

1. After logging into blackbaud.com, click the menu drop-down in the top-left corner and select Admin.
2. On the menu-bar at the top, navigate to Settings > Environments.
3. You may see multiple environments listed here. Find the one that includes Merchant Services. Click the three-dots icon at the bottom of the environment tile and select Invite environment admin.
4. You will need to accept this invitation via email before moving to the next step.

Step 3: Connect to XTruLink via Blackbaud Marketplace

1. In a new browser tab, go to Blackbaud Marketplace.
2. You’ll see a search bar in the middle of the page. Search for “XTruLink”
3. Click on the XTruLink tile in the search results.
4. On the left-hand side of the page, click the Connect button.
5. After connecting, a pop-up might appear asking if you want to navigate to the application. You can close this pop-up.

Step 4: Complete Connection via the XTruLink Dashboard

1. Login to your XTruLink Dashboard (this is your unique ticketapp.org login that includes your organization code in the URL).
2. Navigate to System > Payment Setup.
3. Select BBMS.
4. Click Add a BBMS Account.
5. Click Connect to BBMS.
6. You will be redirected to a Blackbaud Application Authorization page. You may need to login again with your dedicated Blackbaud user account.
7. Click Authorize.
8. You will be redirected back to the XTruLink Dashboard.
9. Select the BBMS payment configuration you’d like to use as indicated.
10. Click Confirm and Save.

When the connection is successful, you will see your BBMS account listed as Active on the BBMS Setup page under Connected BBMS Accounts.