Configuring Blackbaud Merchant Services Payment Gateway in VanillaSoft

This article provides a complete guide to configuring the Blackbaud Merchant Services (BBMS) payment gateway in VanillaSoft. You can configure the Payment Gateway at either the account level or project level, allowing flexibility depending on your organizational needs. The configuration enables Callers to process payments securely through VanillaSoft. Please ensure that the Payments API is enabled for your BBMS account before proceeding. Contact Blackbaud support if it is not yet enabled.

Step 1: Add the VanillaSoft Application to Your Blackbaud Account

  1. Navigate to Blackbaud App Manager: Go to Blackbaud App Manager (you must log in to your Blackbaud administrator account to access).
  2. Connect the Application: Select Connect App and paste the Application ID: c5f1a2d9-01d7-4f07-bd5f-ac3660df1f72, then click Connect. The application will appear in the list of connected apps.

Note: Blackbaud recommends creating a dedicated user account specifically for authorizing Payments API requests. This prevents authorization issues when an individual account holder is unavailable.

Step 2: Add a User with the Payments Role

  1. Navigate to the Payments API Portal: Log into your Blackbaud environment and open the Payments API Portal.
  2. Configure Payments Role:
    1. Go to the Security section, then the Roles tab.
    2. If no Payments role exists, click the plus sign to create one.
    3. Enter a role name and description, then under SKY API Tasks, select Access all endpoints.
    4. Click Save to finalize the role creation.
  3. Add a User to the Payments Role:
    1. Navigate to the Users tab and click Add User.
    2. Enter the user’s name and email address, then select the Payments role from the drop-down list.
    3. Click Send Invite to email the user an invitation to access the role.
  4. Approve Application Access: Log in as the new user, navigate to the connected VanillaSoft application, and approve access on the user’s behalf.

Step 3: Configuring the Blackbaud Merchant Services Payment Gateway in VanillaSoft

Configuring for Your Entire VanillaSoft Account

  1. Access Account Settings: From the Admin homepage, select Account in the top menu.
    Access Account Settings
  2. Open Payment Gateway Tab: Select the Payment Gateway tab from the top menu.

  3. Enable Project-Specific Gateway (Optional): Check or uncheck the Enable a payment gateway to be set up for each individual Project checkbox as desired.

  4. Select Payment Gateway: From the Payment Gateway drop-down, select Blackbaud Merchant Services (BBMS).

  5. Authorize Gateway: If presented, click Authorize Gateway and log in to your Blackbaud account in the pop-up window.

    • Note: If you don't see the login window, check if pop-ups are blocked in your browser settings.
  6. Configure Gateway Options: Select the appropriate Gateway Options settings for Payment Configuration, Blackbaud Checkout, and Currency.
    mceclip2.png
  7. Integrate Raiser's Edge NXT (Optional): To integrate your Raiser's Edge NXT account, check the Use Raiser's Edge NXT checkbox and configure the desired options and details.

  8. Configure Fields: In the Fields section, check the Required and Visible checkboxes beside the corresponding field names to set which fields are required and/or visible.
    mceclip6.png
  9. Save Settings: After configuring all options, click Save.

Configuring for an Individual Project

  1. Select Project: From the Admin homepage, select the project you want to configure.
    Select Project
  2. Access Payment Gateway Settings: Open the Integration menu and select Payment Gateway.

  3. Select Payment Gateway: From the Payment Gateway drop-down, select Blackbaud Merchant Services (BBMS).

  4. Authorize Gateway: If presented, click Authorize Gateway and log in to your Blackbaud account in the pop-up window.

    • Note: If you don't see the login prompt, check if pop-ups are blocked in your browser settings.
  5. Configure Gateway Options: Select the appropriate Gateway Options settings for Payment Configuration, Blackbaud Checkout, and Currency.
    mceclip2.png
  6. Integrate Raiser's Edge NXT (Optional): To integrate your Raiser's Edge NXT account, check the Use Raiser's Edge NXT checkbox and configure the desired options and details.

  7. Configure Fields: In the Fields section, check the Required and Visible checkboxes beside the corresponding field names to set which fields are required and/or visible.
    mceclip6.png
  8. Save Settings: After configuring all options, click Save.

Step 4: Enabling the CC Payment Form for Callers

  1. Select Project: From the Admin homepage, select the project where the payment gateway is configured.
    Select Project.jpg
  2. Access Panel Layout: Open the Page Layout menu and select Panel Layout.

  3. Select CC Payment Tab: Open the Available Tabs drop-down and select CC Payment.
    2.jpg
  4. Choose Panel Location: Open the Panel drop-down and select which panel you want the CC Payment tab to appear.
    3.jpg
  5. Add the CC Payment Tab: After selecting the panel, click the Add button to include the CC Payment tab.
    4.jpg
  6. Save Layout: Once everything is set, click Save.
    5.jpg

By following these steps, you can configure the Blackbaud Merchant Services payment gateway in VanillaSoft for both account-wide and project-specific needs. For more detailed information or assistance, please refer to the official Blackbaud support resources.

Was this article helpful?

Related articles