As of early 2025, Blackbaud now mandates the use of their Blackbaud Checkout (BB Checkout) interface to process payments. So, if you’re still using eft and credit card fields in your forms, you need to switch to the BB Checkout field.

To use this field you must first enter your credentials, then add the field(s) to your forms.

1. Go to your Forms>Settings>eTapestry Payment and Check Serial Key to make sure your active serial key is registered.
2. On the Payment plugin settings, enter your credentials for the BB Checkout field. The instructions for finding those in your eTapestry account are in the field settings information
3. Go to your payment form(s) and replace the existing credit card and eft/echeck fields with BB Checkout fields. Each BB Checkout field has a setting for specifying whether it is for eft or credit card. See screenshot attached
4. Re-establish any conditions under which the BB Checkout fields will show if applicable. (This was likely already set up if you had both credit cards and checks fields on your form so you just need to apply the same conditions to your BB Checkout field.) If you only accept one payment type, you only need one BB Checkout field and no conditions need apply.

This creates a secure Blackbaud window injected into your form that directly interfaces with Blackbaud’s server.

NOTE: if you wish to automatically submit the form when the user completes the payment through the BB Checkout window, use a filter in your functions.php file:

You may wish to add a condition based upon the form id. The following code will force auto submit on all forms with the bb checkout field in play.

add_filter('eTapPayment_bbcheckout_fields', function($fields, $form){
	// can check form['id']  first if desired.
	$fields['autosubmit'] = true;
	return $fields;
}, 10, 2);

Screenshots:
Settings in the BB Checkout field. Select the transaction type and if the field is required. If you have more than one BB Checkout field in your form, be sure to set a conditional to only show the correct field (usually based upon a Payment Method radio button selected by the user).