Direct Debit 2.0 - Direct Debit Enhancements

New Features for Direct Debit

In Direct Debit 2.0, we have introduced a new feature that allows us to handle the automatic updates on payment methods. The GoCardlessWebhookTransferredScheduler scheduled job will automatically update the bank details and mandate id whenever there are Transferred/Replaced mandate changes in Gocardless.

In addition, a new custom object has been added to the Direct Debit API to enhance performance and provide a method for staff to review and process payments through Direct Debit. This new object, GoCardless Webhook, will serve as a way for staff to:

• See the status of payments

• Run new scheduled batch jobs to handle exceptions

• Manually run scripts or process single records      

Step 1: Install or Update Direct Debit

1. From the Spark Admin Object, select Product Updates.

2. The Product Updates page will display all available packages, which includes DirectDebit. Click the Install or Update button, depending on your organization’s use of Direct Debit.

3. When the install/update is complete, an email notification will be sent to the system administrator, and you will receive a Success notification message. 

Step 2: Setting Up GoCardless Webhook

1. Run Access Manager for the Community profile, the Fonteva Customer Community Login User profile, and the Guest user profile. For more information on Access Manager, Click Here.

2. Configure old and/or Add new API Service Connections. For more information on API Services, click Here. New API Service Connections:

   1. Last_N_Days is used in the GoCardlessWebhookBatch, and GoCardlessWebhookTransferredBatch. Note: if you choose not to create this connection, then the batch query’s default value will be 1

   2. Delete_Last_N_Days is used in GoCardlessWebhookRemovalBatch. Note: if the user does not create this connection, then the batch query’s default value will be 200

3. Schedule three new batch jobs. To learn about batch jobs, look Here.

   1. GoCardlessWebhookScheduler will pick records that haven’t been processed and schedule them to be processed

   2. GoCardlessWebhookTransferredScheduler will process the transferred and replaced records

   3. GoCardlessWebhookRemovalScheduler will remove records that have already been processed

4. Add the Process Webhook button to your page layout. For more information on updating your page layout, click Here.

Manually Running Scripts

The batch jobs created in the previous section will automatically process payments and mandates. If you wish to run the scripts manually or process a single record, you can do so through Spark Admin.

Option 1: Process Payments and Mandates Manually

Users can Process Payments and Mandates manually through Spark Admin

1. Go to Spark Admin > Apps > Fonteva Direct Debit.

2. In the Custom Scripts section, run the appropriate script by clicking the Run hyperlink:

   1. Process Payments and Mandates will process all Gocardless Webhooks Except Transferred/Replaced Status

   2. Process Transferred/Replaced Mandates will process all GoCardless Webhooks with the status of Transferred/Replaced

   3. Remove Processed Records will remove all processed payments/mandates

Option 2: Process a Single Record

If appropriate, users can process a single record by using the Process Webhook lightning action.

1. In the GoCardless Webhook object, double-click to select the record you would like to process.

2. In the Highlights Panel, select the Process Webhook Lightning Action

New Fields Added:

There are two new fields added to support the Direct Debit enhancements:

1. GoCardless PaymentID has been added to the ePayment order and is set as the ExternalID.

2. GoCardless Mandate has been added to the Payment Method and is set as the ExternalID.

Scheduled Jobs

Below is the list of scheduled jobs to be configured in relation to Direct Debit GoCardless.