Skip to main content

Using mandate schedules

FinDock uses mandate schedules to collect mandate records for registration. New mandates that fit the parameters you define with the schedule are collected into a registration file generated by ProcessingHub. The file format and transfer process depends on the payment method and processor defined by the mandate schedule.

note

With the July ‘21 release, there is a new default Lightning page for Mandate Schedule. This page includes a Progress Path component and uses dynamic fields. If you have your own page layout that you prefer to use, you can change the default layout for the Mandate Schedule object in your Salesforce settings.

Create a mandate schedule#

To create a mandate schedule:

  1. Launch the FinDock app.
  2. Click the Mandate Schedules tab and click New.
    New mandate schedule
  3. Fill out the schedule information as needed. Use the tooltips and refer to the Mandate Schedule object field descriptions for guidance.
  4. Click Save to store the schedule, or click Save & New to save the schedule and open a new one.

Create multiple schedules with recurring mandate schedule#

The Recurring Mandate Schedule allows you to easily create multiple mandate schedules over a given period. This helps ensure all mandates in FinDock that need to be registered are registered and active in time for your scheduled payment collection(s).

note

If you have an existing org that got the July '21 release update, please click the Deploy Config button on the FinDock Setup tab. This is needed to deploy your existing targets to the Target picklist on Recurring Mandate Schedule.

To create a recurring mandate schedule:

  1. Launch the FinDock app.
  2. Click the Recurring Mandate Schedules tab and click New.
  3. Select daily, weekly or monthly frequency, and then click Next.
  4. Fill out the schedule information as needed. Use the tooltips and refer to the Recurring Mandate Schedule object field descriptions for guidance.
    New recurring mandate schedule
  5. Click Save to store the schedule, or click Save & New to save the schedule and open a new one.

Once saved, you get a preview that includes a list of the mandate schedules that will be generated at the bottom of the page. You can modify dates or remove schedules directly from the list. Until this point, no changes to Salesforce data are made.

Generated mandate schedules preview

After you are done with your modification in the preview, click Create Mandate Schedules. At this point the mandate schedule records are created in Salesforce.

Running a mandate schedule#

Whether and how to run a mandate schedule depends on what payment method, scheme and processor you use. See the specific Bacs, SmartDebit or SEDA articles for instructions.

The main tool for running schedules manually is the Mandate Schedule Path. Click Start Generation to start the schedule processing. The path and button are dynamic and provide information about how to proceed. However, as noted above, there are variations depending on the context.

Mandate schedule path

Auto-create and run mandate schedules#

Through auto-create and auto-run capabilities, you can set up fully automated management of Mandate Schedules to ensure mandates in your org are registered and active in a timely manner.

Automatically create mandate schedules To automatically create payment schedules, create a recurring mandate schedule and select the auto-create option schedule. This tells FinDock to automatically create mandate schedules according to the parameters you define on the recurring schedule.

Automatically run mandate schedules The auto-run feature is enabled for a given payment processor and method combination. When enabled, any mandate schedule with that combination is automatically run on the scheduled run date. Both the generate and process phases of the schedule are automatically triggered.

If you create a mandate schedule that you want to run manually, you can select the “Exclude from Auto Run” option on the schedule and run it manually by changing the status on the mandate schedule record.

Prerequisite: FinDock Heart Beat Apex job To automatically create and run mandate schedules, FinDock requires the Heart Beat job to be scheduled.

Enabling automated mandate schedule runs#

Automated mandate management can be configured per payment processor and method.

To enable Auto Run for a certain payment processor and method combination:

  1. Launch the FinDock app and click the Setup tab.
  2. Go to the ACTIVATE / DEACTIVATE tab and click Payment Method next to the processor you want to configure.
    Payment methods configuration with mandate schedule management
  3. Click the cog wheel next to the payment method you would like to automatically collect.
  4. Click the Auto Run toggle and then Close.
  5. Check if the grey pause icon next to the payment method has turned into a blue play icon.
    Payment method configuration with automated mandate management enabled

Once auto-run is enabled, all payment schedules with the given processor and method combination are run automatically unless you explicitly exclude a payment schedule by selecting the “Exclude from Auto Run" checkbox on the schedule.

Enabling automated mandate schedule creation#

You can use recurring mandate schedules to generate a fixed number of mandate schedules (normal use) or to create an unlimited number of schedules (automated use).

If you want to use a recurring mandate schedule for automated mandate management, create a new schedule (see above) and select the Auto Create option.

When using auto-create, you also need to define:

  • Run Date Conflict Strategy: this determines how FinDock handles a run date that falls outside business hours. The options are:
    • Run on previous working day
    • Run on next working day (default)
  • Processing Date Conflict Strategy: this determines how FinDock handles a processing date that falls outside business hours. This is only used for Bacs Direct Debit with FinDock as processor. The options are:
    • Process on previous working day (default)
    • Process on next working day

To check whether recurring mandate schedules have been configured for a certain payment processor and method combination:

  1. Launch the FinDock app and click the Setup tab.
  2. Go to the ACTIVATE / DEACTIVATE tab and click Payment Method next to the processor you want to configure.
  3. Check the number in the circle under AUTOMATED MANDATE MGMT. This indicates the number of recurring schedules configured. Payment methods configuration with mandate schedule management active
  4. Click the cog wheel next to the payment method you would like to automatically manage.
  5. Under Automated Management of Mandate Schedules - Recurring mandate schedules that automatically create mandate schedules, you will find a list of recurring manate schedules configured for this specific payment processor and method combination.
    Recurring mandate schedules for a specific payment method