Setting up your Stripe payment integration
Sumac can record payment information, and process credit card payments instantly. For example, you may want to use Sumac to process payments for donations, membership fees, or registrations. In order for Sumac to process payments, you must first open a merchant account with one of Sumac's supported payment processors: iATS or Stripe.
This article describes how to set up your integration with our payment partner Stripe.
Setting up your Stripe integration
When your merchant account is opened, Stripe provides you with a list of account numbers, IDs and passwords. Some of them are for logging into your Stripe account. Others are used to configure a card swipe machine (if you've got one). Finally, others are for telling Sumac how to connect and process payment transactions.
Sumac requires your Stripe Account ID, and the currency you intend to use with your Stripe account (either CAD or USD). Once you’ve retrieved these details, your Sumac Administrator must enter this information into your database.
First, from your main Sumac console, expand Utilities > Customize Database > Preferences.
Go to the Payments tab. Open the “Payment Processor Name” drop-down menu and select “Stripe.” Sumac will fill in Stripe's website details for you. Next, in the Payment Processor Account ID field, enter your Stripe Account ID. In the Payment Processor Currency field, enter the correct currency to use with your Stripe account (i.e. either CAD or USD).
The Payments tab provides a few other preferences you may want to consider using. For example, if you wan to make Account Codes mandatory in payment records, put a check mark next to "Account Codes are mandatory in payment records."
One other option on this page is occasionally necessary for payment processing. When a payment processor requires address verification for processing credit cards, Sumac normally uses the contact's preferred address – either their residence or business address. If you want to force Sumac to always use the residence address, put a check mark next to "Use residence address."
Once you have completed the steps above, click OK to save these changes, then restart Sumac to ensure all these changes take effect. Now Sumac is configured to process payments!
Testing your Stripe integration
At this point, it's a good idea to test processing a payment to ensure that everything works properly. In your Sumac console, expand "Financial" and click "Payments." Click "New" to add a new Payment record.
Choose a contact to test with, then enter an amount for this payment.
Choose a Payment Type that applies to a credit card (e.g. Visa). Then enter a credit card number, expiry month and year, verification, and the name for the credit card. When done, click "Process" to test processing this payment.
You should not use a real credit card number, as it may process a payment on that credit card. We suggest using a credit card number designated for testing purposes. Stripe may provide you with test account numbers and transactions so that you can confirm that credit card processing is working properly.
Sumac should give you an error message saying that the credit card information cannot be authenticated. This is a good sign! It means that Sumac is correctly set up for processing payments. It was able to send the credit card information to Stripe and receive Stripe's response.
Any time a payment is not processed successfully, Sumac receives the error message from Stripe and displays it in the payment record.
When a payment is processed successfully, then the authorization code is filled in, and the transaction is closed and saved to the database.
Considerations for web integration
If you are integrating Sumac with your website for online donations or membership renewals, it's a good idea to confirm that the Payment Types you have set up are using the correct Payment Processor Code for Stripe.
Note: the Payment Processor Code comes built into Sumac. In nearly all cases, you do not need to adjust anything for your Payment Types.
However, if you would like to double-check, need to make adjustments, or if you're setting up a brand new Payment Type that was not built into Sumac, follow the steps below.
- From your Sumac console, expand Utilities > Customize Database > Field Values. Choose the Area: Payments, then choose the Field: Payment Types.
- Double-click an existing credit card Payment Type, and review the information in the Payment Processor Code field.
- If you notice a change is needed, make the necessary change to the Payment Processor Code as defined by Stripe, and click OK to save it.
Our products got an upgrade!
Some screenshots and help videos have been made using older versions of our products. Though your version's colours and themes may appear different than what you see here, the instructions, links and advice in this article are still accurate and useful!
Related Articles
Setting up your iATS payment integration
Sumac can record payment information, and process credit card payments instantly. For example, you may want to use Sumac to process payments for donations, membership fees, or registrations. In order for Sumac to process payments, you must first open ...Sumac and QuickBooks: Setting Up Your Integration
Setting Things Up Sumac can integrate directly with Quickbooks to send General Ledger Entries from Sumac to Quickbooks for financially significant types of data. Before data can be transferred directly from the Sumac database to your accounting ...Website Integration Guide – Setting up Sumac for online Course Registration
Before you are able to start using your Courses web page, you need to tell Sumac which payment processor to use when charging fees for registrations. To do this go to Sumac Console/Utilities/Customize Database/Preferences/Payments. In the Payments ...How to set up your website integration
You will need The following are required before you can complete the setup of your website integration A website! You will need access to the back-end of the site in order to complete this setup. A payment processor account. We work with Stripe or ...How does Sumac process payments in multiple currencies?
To be able to track contacts from different countries and process payments for them in their local currency, use a feature of Sumac called Segments. In Sumac, you can group contacts together under different segments, and you can define as many ...
Societ Academy
Learn what you need to know, any time. Free!
- High quality training on demand - sessions are available every day, so you can access training that fits into your schedule.
- Training sessions that are easy to follow - helpful tips throughout each session, and access to training moderators ensure your questions get answered.
- A certificate of completion - you can request a certificate of completion for every session you attend.