Using the GoCardless Simulator

In sandbox environments, GoCardless offers scenario simulators that enable you to manually trigger specific scenarios. This allows for efficient testing and accelerates scenario outcomes without having to wait for GoCardless’ standard processing times.

This article explains how you can work with the simulator and test the functionalities of GoCardless for Dynamics 365 Business Central – TAPP.

For any questions, please reach out to Bluefort Support at support@bluefort.eu.

⚠️

WE ARE CURRENTLY AWARE THAT THERE IS AN ISSUE TO SIMULATE INSTANT BANK PAYMENTS DUE TO AN ISSUE IN GOCARDLESS’ SIMULATOR.

Pre-requisites

• Access to your GoCardless Sandbox environment
• A merchant should have successfully been onboarded in GoCardless for Dynamics 365 Business Central – TAPP – see how this is done here.

Accessing the Simulator

Follow the below steps to access the simulator:

1. Log in to GoCardless Sandbox
2. Access the Developer section and click on Simulate a Scenario

3. From the dropdown, select the scenario to simulate and provide the resource requested (more information per scenario is provided later on in this article)

4. Click on Simulate Scenario

Simulating Scenarios

Below is a walkthough of the scenarios required to be simulated to test functionalities provided in GoCardless for Dynamics 365 Business Central – TAPP

Activate a customer mandate

Fulfill a Billing Request and pay out the payment

Fulfill a Billing Request and fail the payment

Confirm a payment

Submit a payment

Pay out a payment

Fail a payment

Accessing GoCardless resources required for simulation

Below is a walkthough of how to access and acquire the resources required to use during simulation of scenarios via GoCardless to test functionalities provided in GoCardless for Dynamics 365 Business Central – TAPP.

Billing Request ID

1. Upon posting the payment action via Business Central, navigate to the Events section in the GoCardless Dashboard.
2. Filter where Resource is Billing requests
3. Find the related Billing Request and copy the Billing Request ID

Payment ID

1. Upon posting the payment action via Business Central, navigate to the Payments section in the GoCardless Dashboard.
2. Select and open the required payment ant copy the Payment ID

Mandate ID

A mandate can be located starting either from the customer or the payment as follows;

Retrieve mandate ID from the customer

Retrieve mandate ID from the payment

Choosing the correct bank for simulation

During scenario simulation, GoCardless will ask to select a test Bank Account to use during the test. Below is the list offerred by GoCardless;

Each bank is accompanied with a description that advises what will be the scenario outcome example;

• Payment Failed Insufficent Funds Bank: Using this bank will simulate the scenario where a payment will fail due to insufficient funds on the customer’s end.
• Read Refund Account Bank: Using this bank will simulate the scenario of an authorized payment.