1. Configuration in your GoCardless account
billwerk supports all plans offered by GoCardless.
Create an access token in GoCardless and enter the URL https://app.billwerk.com/PSPWebhooks/GoCardless as the webhook URL in your GoCardless account for live mode.
When using Full Version API (Pro Plan), the "Custom Mandate References" feature must be enabled by GoCardless support for the merchant account.
2. Configuration in your billwerk account
You can find the GoCardless configuration in your billwerk Account at "Settings > Payment Settings > GoCardless".
Please pay attention, to select the correct integration type (Redirect Flow API or Full Version API). The integration type depends on the plan you have booked at GoCardless (Standard, Plus plan is Redirect Flow API, Pro plan is Full Version API). A wrong selection leads to an error: "PermissionDenied", "Forbidden request"
Insert all needed data in billwerk and press the "Save" button. Now you can select Direct Debit with GoCardless in the payment service provider selection. Save the selection again und now you are able to use GoCardless for direct debit payments.
Note that in order to create a direct debit mandate, your customer's billing address must either be completely free or completely filled. Only partially entered address fields lead to errors in GoCardless.
3. Test data
At https://manage-sandbox.gocardless.com/signup you can register for the GoCardless sandbox. Create an Access Token and enter https://sandbox.billwerk.com/PSPWebhooks/GoCardless as your Webhook URL in your GoCardless account for test payments.
You can find GoCardless test bank details here.
4. Customer data
GoCardless defines mandatory attributes that have to be saved in the customer data for payments to be successful:
- Company Name or First Name and Last Name