Last updated January 2018
To get started, you need access to both your NationBuilder and Authorize.net accounts. If you don’t have an existing Authorize.net account, create one from their website.
You must have access to your Authorize.net account to retrieve specific information that is necessary to connect with your nation.
Table of Contents
- Get your API credentials and key from Authorize.net
- Connect with Authorize.net
- Manage recurring donations in Authorize.net
- Related HOWTOs
- Issues and suggestions on our radar
Get your API credentials and key from Authorize.net
To connect NationBuilder with Authorize.net, you need your API Login ID and Transaction Key - two unique values used to authenticate your authorization to process transactions through your website.
Note: The API Login ID and Transaction Key should not be shared. Keep your Transaction Key in a safe place because once it’s created, it can no longer be viewed. Changing the Transaction Key on a regular basis is recommended to strengthen the security of your account.
Access your Authorize.net account and click Account from the main navigation bar.
Select Settings from the left-side menu.
From the "Security Settings” section, select API Credentials & Keys.
Locate your API Login ID. You can also view the date and time you last obtained your API Login ID.
Go to the “Create New Key(s)” section and enter the “Secret Answer” to the “Secret Question."
Select “New Transaction Key.” Once you do, you have the option to check off the box to disable the old transaction key immediately. If you select this option, the old Transaction Key will expire right away. If you do not select this option, the old Transaction Key will expire in 24 hours.
Click on Submit to receive your new Transaction Key.
Once you store your Transaction Key information in a safe place, click Continue and you’ll be redirected to your account settings.
Connect with Authorize.net
Once you have both your API Login ID and your Transaction Key from your Authorize.net account, access your NationBuilder control panel.
Go to Settings > Payment processors > New processor and select Authorize.net from the "Select provider" dropdown under "Third-party processor." Click the Add payment processor button.
On the New processor page:
1. Enter a name.
2. Get your Authorize.net API Login ID and Transaction Key. Copy the two values and paste them into the appropriate “API Login ID” and “Transaction Key” fields. Authorize.net is one of the payment processors that supports recurring donations. If you are using Authorize.net for recurring donations, a silent post URL will appear below the Transaction Key field once your account is created, like in the example below.
3. Look at the list of credit card types Authorize.net accepts and check the ones you want to use with your account.
4. You can also select a time to settle your funds in the “Settles nightly at” field. When you select a time, such as 8:00 PM, the approved transactions get submitted to Stripe for clearing at that time.
5. If you use Customer Information Management (CIM) in Authorize.net, you can enable this add-on in your nation. When a transaction is made, the customer data from NationBuilder will get stored in Authorize.net - a customer profile gets created, associating transactions from a returning donor with the existing profile. If you don’t use CIM, learn more about it from Authorize.net.
6. If you want your Authorize.net account to be in test mode, check “Testing mode.” Remember to also set your Authorize.net account to test mode to ensure that no transactions are processed from both NationBuilder and Authorize.net.
7. You have the option to choose a description for your organization through the “Type of organization” dropdown menu. The different options include for profit, nonprofit, charity, individual, federal_candidate, federal_pac, federal_party, state_candidate, state_pac, state_party, local_candidate, local_pac, and local-party.
8. Choose how donors will interact with your donation page. First, decide whether the donations are tax deductible. This status will appear on the donation page and on donation receipts.
9. You may require a donor’s employer and occupation information, the employer’s full address, or just the employer’s city and state.You may also include corporate contribution fields. If you are a political campaign, check your local and Federal regulations to see if you are required to collect this information. Activate any setting by checking the appropriate box.
10. If your organization has a specific disclaimer or contribution rules required to accept donations, enter that copy in the "Contribution rules" text box. This includes specific disclaimers mandated by campaign finance law. Donors will have to check a box accepting these statements before submitting a donation.
11. Once you’re done filling out the form, click the Save account button. A donation page that is connected to this payment processor will pull from these fields.
You’ll see your newly added payment processor in Settings > Payment processors > All processors.
Manage recurring donations in Authorize.net
Authorize.net is a payment processor that supports monthly donations and installment payments. To support recurring donations, you must enable the Automated Recurring Billing™ (ARB) add-on from your Authorize.net account. If you do not, there is no way for Authorize.net to process recurring donations from your nation.
- To retrieve the silent post URL from your NationBuilder control panel, go to Settings > Payment processors > All processors and click on the pencil button next to your Authorize.net account.
Locate your silent post URL below the Transaction Key field.
- Once you have your silent post URL, access your Authorize.net account and click Account from the main navigation bar.
- Select Settings from the left-side menu.
From the “Transaction Format Settings” section, click on Silent Post URL.
- In the URL field, enter the silent post URL you received from step 2.
Once you click the Submit button, you will get a message if the URL was successfully applied.
Issues and suggestions on our radar
There are some issues related to the integration with Democracy Engine that have come to our attention. We are monitoring their importance to the community on the product issues and suggestions page. You can follow each of the below issues to keep updated on their status.