Introduction
This article explains how to set up and use either a Stripe Express or Stripe Standard account in CiviPlus. The account type is agreed with you during the initial sales process, and your CiviPlus site will be configured accordingly. If you later decide to switch from Express to Standard, or vice versa, this can be done. However, you’ll need to contact our Account Management team, who will walk you through the process.
Important
Recurring payments are not supported with Stripe
Stripe Express does not currently provide payout level transaction grouping in CiviPlus
Navigating to Stripe settings
Enabling Stripe
Stripe is not enabled in CiviPlus by default and must be enabled and configured before use. Compuco will enable the Stripe extension on your behalf, and make sure that your Administrator has the correct permission to complete the configuration.
This step is the same for both Express and Standard account holders. All settings relating to Stripe live in the Administer menu, under “CiviContribute” and then “Stripe Account”
If you can’t see this option, please enter the following into the browser bar: /civicrm/stripe/account
Click ‘Set up payments’ in order to start with your new Stripe account setup
If you do not complete all the following steps, you can return to this screen at any time and you will see the following:
Express account onboarding steps
Creating the connected account
Stripe will take you through a number of settings* to complete your account setup, starting with this screen.
If you have an existing stripe account, you can use the same email address and password from your existing account at this stage. However Stripe Express has a different interface from Standard accounts, and logging in to Stripe express you would only be able to see the payments to that exact account.
Please note that in test mode, only a phone number is needed to login, but in Live mode, you might need to use an email address instead.
These steps will include setting up two factor authentication:
Once two factor authentication has been enabled, please ensure to keep your backup codes safe
Logging in for the first time
With the setup information completed, Stripe will send you an email to verify your new account; please ensure to click the verification link as soon as possible
Standard account onboarding steps
Creating a connected account (if you have no existing Stripe account yet)
Stripe will take you through a number of settings/questions to complete your account setup, starting with this screen.
If you have an existing stripe account, use the exact same email address and password from your existing account at this stage. *
* See “Creating a connected account if you have a Stripe account already” section below
These steps will include setting up two factor authentication:
Once two factor authentication has been enabled, please ensure to keep your backup codes safe
Logging in for the first time
With the setup information completed, Stripe will send you an email to verify your new account; please ensure to click the verification link as soon as possible
Once your verification is complete, your account will show as active.
You can upload a brand logo should you wish at this stage.
Creating a connected account if you have a Stripe account already
If you have an existing stripe account, please use the exact same email address here, and Stripe will recognise whether you have an account already.
Please use the exact same email address and password from your existing account at this stage.
Enter the verification code that you received via a text message.
Select your existing business and click Continue
If you don’t see this option, you will have to set up a new business.
If you get a screen like this, please click Retry button and see if you get navigated to your Stripe account. If not, please contact us!
Verified account
If you had a user account before and just logged in through the setup screen, then you will see an arrow when hovering over the account name at the top left corner. Clicking that arrow will display the different account types associated with your user account. One of them is the original account that you had before the setup on CiviPlus, and the other one is the new that is connected to your CiviPlus.
Returning to your dashboard
This step is the same for both Express and Standard account holders. With your account set up and fully verified, you can easily return to your Stripe dashboard at any point by re-visiting the same settings screen:
Using Stripe on contribution and event pages
Contribution pages
An existing or new Contribution page needs to be configured with Stipe so that online payments can be made.
Navigate to Finance -> New Contribution Page to create a new Page, or Finance -> Manage Contribution Pages if you are going to amend an existing page. In the example below we have created a new Contribution page and gone to the Amounts tab in order to make sure that the following are configured:
Execute real-time monetary transactions - This has to be checked in order to online payments to be allowed.
Currency - a currency for the transaction must be provided.
Payment Processor - Stripe needs to be checked to give the option to user to pay using this payment processor. You can allow other payment methods as well.
Important: The currency is defined by the contribution page and will be used regardless of the payer’s location or Stripe account base currency.
Stripe Payments via a Webform
Within the CiviCRM tab of the Webform configuration make sure that the correct Stripe-enabled Contribution Page is specified. You webform will also need to calculate the Contribution Amount (in this example we are simply exposing the field), and either select Stripe or User Select as the Payment Processor.
Now when the user completes the form they will be prompted for credit/debit card details, which will be processed by Stripe when the Submit button is pressed.
The contribution will be added to the contact record in CiviPlus:
Event registration pages
Stripe can also be enabled on event registration pages by selecting it as the payment processor in the event configuration.
Refunds
You should always make refunds from within the CiviPlus interface when using Stripe rather than making them from within the Stripe interface.
Refunds made from Stripe will not be reflected automatically in CiviPlus.
Instead a user would need to record this manually in CiviPlus.
To issue a refund:
`Expand the contribution to see the payments and you will see the option to make a credit card refund:
Click Submit Credit Card Refund, that will open the create refund screen.
Select the payment to refund (as there maybe multiple payment relevant to a contribution), then the amount to refund and the reason. Click Create the refund.
Note: Refunds take time to process
PCI DSS SAQ A Compliance
CiviPlus customers who use the Compuco Stripe integration described in this article to process credit and debit card payments through webforms qualify for PCI DSS SAQ A as all cardholder data entry and payment processing is fully handled by a Stripe, and the CiviPlus servers do not store, process, or transmit cardholder data.
Annual PCI Attestation
You should complete the SAQ A questionnaire annually and submit the Attestation of Compliance to your acquiring bank if required.