ActionKit integrates with Braintree, Authorize.net, Payflow Pro, and PayPal for credit card processing.
If you are setting up a new account, we recommend Braintree. They are the only vendor who will provide the credit card information so you can take recurring profiles with you to a different vendor. They are also the only vendor who accepts ACH Direct Debit payments, and you can set your account to automatically update credit card expirations where possible. Finally, Braintree can often accept recurring profiles from another vendor if your old vendor is able to transfer encrypted credit card information to Braintree.
You can accept one-time and recurring donations with all of these vendors. Monthly is the recurring default. You can edit your templateset to accept weekly, quarterly or yearly donations if your payment processor supports it. Payflow Pro and Auth.net support weekly donations. Braintree supports quarterly and yearly recurring donations. ACH Direct Debit supports the same options that credit card orders on Braintree do.
You can read a description of how donations are processed and recorded for each vendor, under Donation Processing and Data capture.
Vendors also deal with CVV differently. You may be able to configure your account with your merchant vendor to always or never require this, but you'll need to check with your vendor to confirm. If you've changed your settings so this isn't required by your merchant vendor, you can edit the template for your Donation Pages to not require CVV, since ActionKit does not require it. However, if you remove it from your ActionKit form without changing your settings with your merchant vendor, donations will fail.
Finally, if you are transferring from another system but keeping the same merchant vendor, you can import recurring donation profiles into ActionKit. The historical information provided varies by vendor. Authorize.net does not provide any history but payments that come in after the profile is transferred to ActionKit will be recorded. Historical payments will transfer for Braintree and Payflow Pro.
Following is the information we need to hook up a new account for each vendor and settings we encourage you to use.
We need the following pieces of information for each Braintree account:
- merchant id,
- merchant account id (if you have multiple accounts, like for a (c)(3) and (c)(4))
- public key,
- private key,
If you plan on receiving recurring donations, you need to add one or more new subscription plans. Log in to your Braintree admin console. Navigate to Plans and click on New. For monthly, set the plan id to 1 and the price to 0.00. For annual, choose a plan ID such as "annual" or "12", enter a name and description, set the price to $0, and the billing cycle to 12 months. If you want to offer quarterly donations, repeat that process, choosing a different plan ID and a 3-month billing cycle. All other options can be left as default (no trial period, bill immediately, end date never).
Then file a ticket through the Support Tab. Tell us which Braintree accounts you're using, the plan IDs for the recurring plans and the names you'd like to use. We'll update your site configuration with this information.
If you plan to accept ACH Direct Debit payments, you will need to ask Braintree to add you to their ACH beta program. You will also need to set up the Braintree webhook for ACH transaction settlements as described here. Then send us a support request asking us to enable ACH for your Braintree account.
Each vendor deals with failed recurring donation payments differently. They all retry the charge multiple times on a different schedule as described here.
Braintree will accrue the missed payments and charge for all of them when the card is again accepted. This can lead to a nasty surprise for some of your most valuable donors if their payments fail for a few months and then succeed (for a total that includes the missed months). To avoid billing recurring donors for several months of missed payments at one time, use our custom retry system.
Note that this only applies to recurring credit card donations with Braintree. Recurring donations using ACH Direct Debit are handled by ActionKit directly, and failed payments are never retried. See the ACH Direct Debit Guide for more information.
Additional Information Supported¶
You can also include some additional information with requests to Braintree -- please note that some set up is required first in the Braintree gateway for several of these.
- Email: This will be transferred automatically.
- IP address: There's an instance-wide configuration option. Under Donations Send IP Address is set to False by default. NOTE: You must create the 'customer_ip' custom field in the Braintree gateway prior to enabling the option or ALL donations will fail.
- Custom fields: Inputs on braintree donation pages prefixed with 'braintree' will be submitted as custom fields. Again, the donation will error and fail if a custom field is submitted that has not first been created in the gateway.
- Device data: We've made changes to allow you to take advantage of Braintree's new fraud protection tools, beyond MaxMind. Most groups will not need this, but if you are encountering problems with fraud that you aren't able to reduce using MaxMind, this might be of use to you. You'll need to make some changes to your account settings so if you're interested in finding out more let us know.
For all of the above, because of how donations and recurring donations are structured, the data is attached to the transaction for a one-time donation, but to the customer for a recurring donation.
3D Secure 2.0¶
We now offer support for 3D Secure 2.0 to verify credit card owners who are making a donation on your Braintree donation pages.
To enable this option, create a custom page field called
Add it to your Braintree donation page and set the value to
Template changes to donate, recurring_update, and recurring_info pages. Please consult the template diffs to ensure your template has the correct code.
We can also configure your instance to require 3D Secure for all pages on a Braintree account. Please contact ActionKit support to do this. (Testing first is a must!)
Note that recurring updates will not use 3D Secure unless the account is configured to use it.
We will need the following to hook up a Payflow Pro account:
- Merchant Login
You should receive a welcome message after making your account that will have this information.
Payflow Pro itself doesn't provide a PCI compliant service, but ActionKit has an integration with VeryGoodSecurity (VGS) to that makes PCI compliant Payflow Pro donations possible.
Support for VGS was added to the built-in Original templateset in August 2021, and use of the VGS proxy is now required for Payflow Pro accounts in ActionKit.
If you've customized your donate.html templates, changes may be necessary before VGS will work on your donation pages. Reach out to ActionKit support for pointers on how to add VGS to your templates.
To use PayPal for credit card processing, you follow the steps outlined under enabling Paypal on a donation page.
Once your account is set up, you'll be able to select it under payment account when you create a donation page.
Be sure to test that your account is set up correctly by making a donation. You can reverse this from your individual user record afterward. It's a good idea to set up a recurring donation as well if it's a new account.
The only way to test your account is by making a real donation -- the test set up offered by some merchant vendors is not the equivalent as it often isn't the same code path as that used by the live donation processing.