NetSuite - Mandate creation & events
GoCardless uses direct debit to collect payments directly from your customer's bank account. Before you can do this, your customer needs to give you permission. We call this authorisation a mandate.
The process for getting a NetSuite customer set up with a mandate is outlined in this section.
Note: there are alternative methods for setting up mandates that are outlined in the FAQs.
NetSuite customer - GoCardless input
The first step to setting up a mandate is populating and saving the related fields on the NetSuite customer.
| Field | GC Subtab | Description | Editable? |
|---|---|---|---|
| Mandate ID | GoCardless > Mandates | Displays the GoCardless mandate ID. | N |
| Status | GoCardless > Mandates | The status of the mandate. When a mandate is in a chargeable status, this field will show the mandate as Active or Pending Customer Approval. Otherwise, it will show the unchargeable status from GoCardless (Cancelled, Failed, Expired, or Blocked). | N |
| Currency | GoCardless > Mandates | The currency of the mandate | N |
| Internal ID | GoCardless > Mandates | Internal ID of the mandate object in NetSuite | N |
| Link | GoCardless > Mandates | Links to the mandate object in NetSuite | N |
Requesting mandate links
Next, you’ll use the “Request mandate link” button to generate the link for the customer to set up their mandate. This button will only be selectable if you have the “GoCardless Configuration” field populated on the customer. Once the button is selected, there will be a “Mandate form” pop-up form where you’ll input the following details:
- Currency (required): When the NetSuite multi-currency feature is enabled, the drop-down menu displays the currencies enabled on the “Financial” tab of the customer, cross referenced with the supported GoCardless currencies. Otherwise, it will default to the single currency from your NetSuite account. The mandate link will be generated for the selected currency.
- Redirect URI (optional): You can input an optional redirect URI where the customer will be redirected after they’ve completed the mandate set up through the generated link. If it’s left blank, the customer will remain on a “Success” page. If it’s inputted without the “https://” prefix, this will be automatically appended.
Once you’ve submitted the request, the following details will be populated on the customer within minutes:
| Field | GC Subtab | Description | Editable? |
|---|---|---|---|
| Selected GoCardless currency | GoCardless > Mandate setup | Displays the currency that was selected for the mandate link in the “Mandate form” pop-up. | Via the "Request mandate link" button |
| Redirect URI | GoCardless > Mandate setup | Displays the redirect URI that was inputted on the mandate link in the “Mandate form” pop-up. | Via the "Request mandate link" button |
| Mandate link | GoCardless > Mandate setup | This field shows the mandate link that was generated as a result of the "Request mandate link" button being used. The link can be copied and manually sent to the customer, or it can be emailed to the customer using the "Send mandate link automatically" option. | Via the "Request mandate link" button |
Data flow - mandate link requests
Sending mandate links
If the customer had the “Send mandate link automatically” field set to true when you requested the mandate link, you’ll see the email with the mandate link appear on the “Communication” tab.
Note: this feature only supports sending the mandate link to one email address. If the link needs to be sent to multiple email addresses, it will need to be sent manually using the standard NetSuite Merge & Send function under the Communication > Email tab. This will give you the option to include multiple recipients, adjust the email subject & body, and add attachments.
The customer can then complete the set up of their mandate through the link. These pages can be branded with your company logo and colours through your GoCardless account settings.
Data flow - sending mandate links
Mandate events
After the customer has completed the mandate link, the following details will be populated on the NetSuite customer:
| Field | GC Subtab | Description | Editable? |
|---|---|---|---|
| Mandate | GoCardless > Mandate | Displays the GoCardless mandate ID, and links to the mandate object in NetSuite. | N |
| Mandate status | GoCardless > Mandate | GoCardless > Mandate The status of the mandate. When a mandate is in a chargeable status, this field will show the mandate as Active or Pending Customer Approval. Otherwise, it will show the unchargeable status from GoCardless (Cancelled, Failed, Expired, or Blocked). | N |
The mandate object that’s linked in the “Link” column on the GoCardless > Mandates subtab of the customer contains the following information about the customer’s mandate and associated bank account. This can be referenced when it comes to customer inquiries regarding their payment method.
| Field | Description | Editable? |
|---|---|---|
| Mandate ID | The GoCardless mandate ID | N |
| GoCardless customer ID | The GoCardless customer ID | N |
| Mandate status | The status of the mandate. When a mandate is in a chargeable status, this field will show the mandate as "Active". Otherwise, it will show the unchangeable status from GoCardless (Cancelled, Failed, Expired, or Blocked). | N |
| Reference | The unique reference for the mandate (generated by GoCardless to meet scheme requirements). | N |
| Customer | The NetSuite customer that the mandate is linked to. Only one mandate per currency can be linked to a given NetSuite customer at a time. | Y |
| Created at | The date the mandate was created | N |
| Currency | The currency of the mandate | N |
| Bank name | The name of the bank associated with the mandate | N |
| Account holder name | The bank account holder's name | N |
| Account number ending | The last two digits of the bank account | N |
Things to note:
- Only one mandate per currency can be linked to a NetSuite customer at a time. If a customer needs multiple mandates in the same currency (for example, using multiple bank accounts), you can instead create parent/child customer records, each linked to a different mandate. Alternatively, you can update or remove a customer’s mandate from GoCardless → Mandates → Mandate List.
- If a customer completes the mandate setup more than once for the same currency—using either the same link or a newly generated one—the most recent mandate will automatically replace the previous one in NetSuite. The link can therefore be reused whenever a mandate needs updating.
- Whenever a customer’s assigned mandate changes, any open invoices in that currency are automatically updated to reference the new mandate so future payments are processed correctly.
Data flow - mandate object creation
Data flow - mandate status updates