Setting up UK Direct Debits with the Stripe gateway
The Stripe gateway allows BACS Direct Debit recurring payments for clients in the United Kingdom.
Note: Direct Debits with the Stripe gateway are currently supported only in the United Kingdom. For more details, refer to the Stripe supported payment types table.
Before you begin: Required configuration
Before you configure the UK Direct Debit payment method, ensure the following required items are configured:
- The Stripe gateway is configured, which includes the onboarding process. See Stripe: Getting Started Guide.
- Ensure the default country is set to United Kingdom (Settings > Contacts > General).
- Ensure the Default currency code (Settings > Finance > General) is set to Pound sterling (GBP).
Configuring the UK Direct Debit payment method and connecting it to the Stripe gateway
After the above items are correctly configured, you may create the payment method, ensuring it is connected to the Stripe gateway. Lastly, you must add the payment method to the Staff and Public sets.
Do the following to create the Direct Debit payment method and connect it to the Stripe gateway:
- Go to Settings > Finance > Pay Central.
- Click the Payment methods tab.
- Select Add new payment method:
- Code: The Code field must begin with the two-digit country code and can be followed by any preferred additional characters; for example, UK_DD.
- Name: Enter the Name assigned to the payment method. This is only visible to staff users.
- Type: Select Direct debit.
- (optional) Account: Select the cash account for the payment method.
- (optionalEntity: Select the financial Entity. For more information, refer to Financial entities.
- Gateway account: Select the Stripe gateway.
- Display payment authorization checkbox: Enable to display an authorization checkbox in the cart for this payment method. When this setting is enabled for the payment method, the user must enable the authorization checkbox in their cart before they can submit the payment. The provided HTML text box must have the authorization details that the customer is agreeing to, such as: I authorize {Organization name} to charge my {credit/debit} card for agreed upon purchases. I understand that my information will be saved to file for future transactions on my account.
Note: This setting is required for Australian and New Zealand users.
- Click Save.
Do the following to add the Direct Debit payment method to the Staff and Public payment method sets:
- Go to Settings > Finance > Pay Central.
- Click the Payment method sets tab.
- Select the Staff set:
- Select Add new.
- Enter the Display Name. This name appears to staff users in the Cart.
- Select the Direct Debit Payment Method you just created.
- (optional) Enable Default if you want this payment method selected by default in the staff user's cart.
- Click Save.
- Select the Public set:
- Select Add new.
- Enter the Display Name. This name appears to public users in the Cart.
- Select the Direct Debit Payment Method you just created.
- (optional) Enable Default if you want this payment method selected by default in the public user's cart.
- Click Save.
The recommended workflow for testing Direct Debit transactions is as follows:
- Create a test user.
- Enroll the user in a recurring donation on their behalf.
- Generate and process a future invoice.
- Review the submitted payment in Pay Central Live.
Important! Direct debit payments take six business days to confirm the success or failure of a payment for initial recurring payment enrollments, and 3 business days for subsequent recurring payments. Be sure to account for these processing times for testing.
1. Creating the test user
Create a contact with an email address that you have access to.
Tip! It is recommended to use a Staff user email account for the test user account.
2. Enrolling the user in a recurring donation
Next, enroll the test user with a recurring payment. In this example, we are using donations.
Before you begin, you should confirm the following:
To enroll the test use with a recurring payment, do the following:
- From the public website, go On Behalf of the contact.
- Navigate to the Give Now page.
- From the Gift details section, click Recurring.
- Select a gift frequency. For testing purposes, Monthly is recommended.
- Select Other from the Gift amount field.
- Enter 1.00 in the amount field.
- From the Payment method field in the Payment details area, select the Direct debit payment method.
- Enter the required payment details. Make sure to select the checkbox.
- Click Submit donation.
- Click Confirm from the mandate window.
3. Generate and process a future Donation invoice
Important! As these payments take six business days to confirm the status of a payment for initial recurring payment enrollments, it is recommended to wait six business days before generating the future donation invoice.
Do the following to process a future donation:
- Go to Fundraising > Automatic Payments > Process payments.
- From the Generate invoices tab, generate the invoice.
- From the Review invoices tab, review the invoice to make sure the test payment is included.
- From the Submit invoices tab, enter the date and donor name, and click Find. Submit the invoice.
- Retrieve the processed payment.
4. Review the payment in Pay Central Live
To ensure the success of the payment, review the payments in Pay Central Live.
Additional resources
Review the following resources for further information regarding Stripe or Direct Debits: