Blackbaud Merchant Services (BBMS)
- Sam Louk
- Hani
Blackbaud Merchant Services (BBMS) is a payment gateway Engaging Networks integrates with to process donations. BBMS supports credit card, ACH, and digital wallet payments.
Setting up BBMS
Request the Engaging Networks Sky App ID from Engaging Networks Support
Go to the Blackbaud Marketplace manage page
Connect to the Engaging Networks Sky app using the provided ID
Add a user who has the Payments API user role in your Blackbaud environment. You assign this role in User Management by choosing the Payments checkbox for each user
Follow the steps below to authenticate with Engaging Networks
Setting up BBMS in Engaging Networks
Go to Hello > Account Settings > Gateways
Click
The initial fields are set up as follows:
Field | Description |
|---|---|
Reference name | A unique name for the gateway. It is a good idea for the name to include the type of gateway (e.g. BBMS NA), the currency, and whether it is a live or test gateway. |
Select gateway | Select the Blackbaud gateway. |
Once complete, click Connect to connect to BBMS
A new tab will open prompting you to login to your Blackbaud account (which should be already set up)
After successful authentication of your Blackbaud account, you need to select the configuration profile that you want to use for this gateway
Note that you won’t see the “Test mode” checkbox as this is handled based on the profile that you select
Basic fields required for all payments
Fields added to the Engaging Networks page will be pre-populated in the payment modal. Supporter fields must be on the same page as the payment modal in order to pre-populate.
Form Field | Recommend form block field type | Comments |
|---|---|---|
Email Address | Text with Email Validator | Email address identifying the supporter record |
Payment Type | Select or Radio | *This is optional if the page only accepts credit card payment types, but is required if other types like ACH are accepted on the same form. Credit cards: card |
Donation Amount | Text, Radio with Input or Select with Input with Donation Amount validator | May be entered as a whole number or number with two decimal places. Eg. Twelve dollars may be entered as ’12’ or ‘12.00’. Should not include the currency symbol |
First Name | Text | The cardholder’s first name. |
Last Name | Text | The cardholder’s last name. |
Address 1 | Text | The first address line of the cardholder |
City | Text | The address city of the cardholder |
Country | Select | The country of the cardholder. This should be a 2 character ISO 3166-1 country code. |
Region | Text | The address region of the cardholder. The code should be formatted as ISO 3166-2 subdivision code (without the country element included) for the US and Canada in particular. |
ZIP/ postal code | Text | The post/postal/zip code of the cardholder |
BBMS uses a payment processing overlay so fields for capturing payment details like Credit Card Numbers and Bank Account Number do not need to be added to a form block.
Payment currency
Note that the currency used for processing donations is set within the connected Blackbaud profile, so a Payment Currency field does not need to be passed to the gateway.
Should you wish to offer multiple currencies to your donors, you will need to create separate gateway entries, as well as pages for each currency.
Unlike some other gateways supported by Engaging Networks, BBMS cannot be used with any additional gateways on the same page. This includes other BBMS gateways as well as gateways like Pay via PayPal.
Additional Fields for Processing Recurring Transactions
Form Field | Recommend form block field type | Description |
|---|---|---|
Recurring Payment | Radio with Y and N values | Submitting ‘Y’ will flag the transaction as a recurring payment. Any other value will result in a single payment. |
Recurring Frequency | Hidden field with default value | Permitted values are MONTHLY, QUARTERLY, SEMI_ANNUAL and ANNUAL. |
Recurring Day (optional) | Hidden field | The day of the month on which the recurring payment should be taken. (1-29 are allowed) If left blank, subsequent transactions will process on the same day as the initial transaction. |
Recurring End Date (optional) | Triple select with / delimiter | When this recurring payment should cease. The value must be in the format DD/MM/YYYY |
Testing donation pages
You can use the following information to test pages using BBMS.
Card Holder Name: Any value
CVV: Any value
Expiration date: Any date in the future
Amount: Any value
Desired Response | Card Type | Card Number |
|---|---|---|
Success/Authorized | Visa | 4242-4242-4242-4242 |
Expired card, Please enter a valid expiration date. | Visa | 4000-0000-0000-0069 |
Please call the number on the back of your card, your bank has requested we do not honor this card. | Visa | 4000-0000-0000-0002 |
Insufficient funds in the account. | Visa | 4000-0000-0000-9995 |
Lost card | Visa | 4000-0000-0000-9987 |
Stolen card | Visa | 4000-0000-0000-9979 |
Invalid card verification number | Visa | 4000-0000-0000-0127 |
Invalid account number (RC 231) | Visa | 4242-4242-4242-4241 |