The following information is for customers who have signed up to use their own custom payment pages to collect payment details and authorisation from their clients.
Whilst the GoCardless-hosted payment pages offer a certain degree of customisation, such as displaying your company logo and modifying some colours to match your brand palette, in order to deliver a bespoke on-brand experience to your clients you'll need to design and build your own custom payment pages.
These would be hosted directly on your website or online application and operate in conjunction with a wider integration built with our API to set up new clients.
Requirements and regulations on payment pages vary according to where the client (payer) is located. Our team will provide you with guidelines on what information will need to be displayed and captured on your payment pages to be compliant. You are welcome to display and/or capture additional information, providing all minimum requirements are met.
By implementing custom payment pages you will benefit from :
- Offering a fully customised experience for your clients
- Uncompromised brand consistency
- Full ownership of the experience from hosting directly on your app/website
The setup process
There are two aspects to introducing your own custom payment pages :
i). The design and build of the payment pages themselves
ii). Implementation of the sign up flow and client setup process
1. Designing your payment pages
Custom payment pages can be designed and built to your brand and design specifications. All you need to do is follow the content guidelines provided to you to ensure your payment pages meet the requirements that have been set by the payment scheme for the region(s) your clients will be based.
Ensuring your pages are compliant
The content requirements for payment pages vary depending on where your customer is located, as each payment scheme has different regulations.
As a rule of thumb, the following information is required to be captured/displayed across all schemes:
- The customer’s bank account details
- The bank account holder’s name
- Email address
- Make the customer aware that payments are powered by GoCardless (e.g. by displaying this at the footer of your payment page)
The flow of the payment page would need to follow the following 3 steps:
- Collect your customer’s details (Payment page)
- Display this information back to the customer for them to confirm (Confirmation page)
- Confirm that the process has been completed (Success page)
The list below contains guidelines depending on the Scheme through which you will be collecting your customers’ payments (i.e. where their bank account is located).
- United Kingdom (Bacs)
- United States of America (ACH)
- Australia (BECS)
- New Zealand (BECS NZ)
- Eurozone (SEPA)
- Canada (PAD)
- Sweden (Autogiro)
- Denmark (Betalingsservice)
Once you've completed the design and build of your payment pages, the next step is to submit them to us for approval. If necessary, our team will provide you with feedback on any required changes. Once approved, we will enable a feature on your GoCardless account that allows you to create customers directly via the API.
2. Implementation
Alongside the design and subsequent approval of your payment pages, the client sign up and creation flow will also need to be implemented. This involves integrating with the GoCardless API.
Build + test phase
Follow the steps below to build and test your integration in our sandbox environment.
- Create a sandbox account (testing environment), if you don’t have one already
- Create an access token with read-write access [see here]
- Use the access token to link your sandbox account with your internal system
- Test the customer creation process, as outlined in the developer documentation here*
| * If you do not wish to handle sensitive bank details on your own server, you can alternatively create a bank account for your customer via the Javascript flow. |
Going live
Once you have fully tested your integration and your payment pages have been approved, the final step is to launch so that your new clients can begin signing up through your newly built process.
To move your integration from the testing to a live environment, all you need to do is rotate your access token from your sandbox to your production GoCardless account [see here].