Skip to main content
Logo
Identify a payment Support GoCardless
  1. Support Centre
  2. Account setup & management
  3. Moving existing customers to GoCardless

New Zealand (BECS NZ) bulk change process

  • Bulk change process
  • Client migration data requirements

Bulk change process

To kickstart the bulk change process, you will first need to create a GoCardless account and complete the verification process.

Please note: GoCardless take all requests of this nature on a case-by-case basis. We require certain criteria to be met to process a bulk change.

Payers (customers) in New Zealand need to complete a Direct Debit Instruction (DDI) to authorise merchants to take payments from them via BECS NZ, the local Direct Debit payment scheme.

When a merchant switches to GoCardless from another Direct Debit provider, we are required to transfer active payers’ DDIs over to us from the previous provider. 

This transfer process is known as a bulk change.

 

Important: Payments/subscriptions will not transfer over from your previous provider. You will need to set these up again after customers have been imported to your GoCardless dashboard.

 

The steps involved in the bulk change process are:

1. Let us know you’re ready to begin the bulk change process

To begin, navigate to the Customer section in your dashboard and click Continue on the banner that says Migrate from another Direct Debit provider. 

2. Notify your customers that you’re moving to a new Direct Debit provider

You will need to notify all customers whose DDIs you’ll be moving over to us using the following template notification. 

 

Letter/email/SMS template for merchants to send to customers

Subject: Change of Payment Processor for Direct Debits to (merchant)

From (change date), (merchant) are changing our payment processor for Direct Debit payments. Our new processor, GoCardless (Direct Debit Authorisation Code 1220559 *), will be taking over all Direct Debit collections from this date. Read their privacy notice at gocardless.com/privacy. 

There’s no action required from you, and the change will not affect the service you receive in any way. The only change you will notice is that  ‘GoCardless’  will appear on your bank statement.**

GoCardless will not be responsible for any reversals or refunds relating to previous payments between (the merchant) and customers.

If you have any questions, you can contact us on (merchant contact details) or by emailing the GoCardless customer service team at help@gocardless.com.

 

 

*if you have the custom branding add-on, please reach out to your GoCardless contact for your unique authorisation code).
** if you have the custom branding add-on, your business name will appear on customers’ bank statements.

We recommend that you notify your customers using the same communication channel(s) as you use for other messages (e.g. newsletters, email, post, etc.) to ensure receipt.

The notification must be sent at least 10 calendar days before any payments are taken via GoCardless - this is a BECS NZ scheme rule.

3. Confirm in writing to GoCardless that you’ve notified your customers

You can email us on the ticket we will create when you submit the bulk change request via your GoCardless account, to confirm that all customers have been notified. Please include a copy of any notification emails and/or letters sent to your customers.

4. Upload your existing customers’ details into your GoCardless account

You will need to download the CSV import template, add in your customers’ details, and upload the CSV into your GoCardless account via our bulk change migration flow that you can access via the ‘Customer’ tab in your GoCardless dashboard. Please see below for the data requirements.

5. GoCardless processes the new DDIs

We’ll verify and approve the details you’ve uploaded and then create new DDIs for your customers. Once this has been completed, you’ll receive confirmation from us.

6. Cancel your customers’ previous DDIs

You’ll need to ensure that your customers’ previous DDIs are cancelled. If you’re moving to GoCardless from another Direct Debit provider, they will need to perform this action on your behalf. We recommend that this action is performed on the same date that the new DDIs are created.


Client migration data requirements

IMPORTANT: When completing a BECS NZ migration, it's important to ensure that you complete the following fields correctly in your .csv template; supplying incorrect data can cause mass payment & mandate failures once the details are submitted; see below:

 

COLUMN DATA INFORMATION

A, B, C

Customer.given_name & customer.family_name OR customer.company_name

Enter either customer given name + surname OR company name.

If your previous provider exported your customers' full names in a single cell per whole name, rather than splitting between given name and family name, you can use the text to columns function in Excel to separate. 

Example: Billy & Jean OR James's Jeans

D

customer.email

A valid email address is required for each customer so that they receive notifications from GoCardless about their payments. If you are planning to send your own notifications to your customers, please speak with your Account Executive.

Example: billy.jean@example.com

E

customer.language

This will determine the language of customer notifications.

Example: en

F

customer.phone_number

Example: +64 4 817 9999

G, H, I, J, K, L

  • Customer.address_line1

  • Customer.address_line2

  • customer.address_line3

  • customer.city

  • customer.postal_code

  • customer.country_code

Enter the customer's postal address; each line of the address split across the corresponding columns. 

Example: Flat 12, Half Moon Bay (suburb), Auckland, 2012, NZ

M

bank_account.account_holder_name

This is separate to the 'name' entry fields, since account holder name can differ from the individual (e.g., it could include a middle name) or company name.

Example: Billy Jean

N

bank_account.account_number

A BECS NZ-enabled bank account must be used for BECS NZ Direct Debit payments.

Example: 1234567-00 

Important: A hyphen must be added between the account number and suffix, as outlined in the example above (1234567-00).

O

bank_account.branch_code

Example: 0123

P

bank_account.bank_code

Example: 01

Q

bank_account.metadata.bank_custom_key

(Optional) - Use this field to add a custom reference for your customer if required. This will be assigned to your bank account within your dashboard and is a searchable field.

Example: JAM12251

R

customer.metadata.custom_reference

(Optional) - Use this field to add a custom reference for your customer if required. This will be assigned to your customer within your dashboard and is a searchable field

Example: GYM12251

S

mandate.metadata.mandate_custom_key

(Optional) - Use this field to add a custom reference for your customer if required. This will be assigned to your mandate within your dashboard and is a searchable field.

Example: WIL12251

Was this article helpful?
  • Promoted articles

    • Credit card payments
    • Bulk importing payments
    • Overview of payment statuses
    • Refund a payment
  • Recently Added Articles

  • Top Articles

API Documentation

Our detailed docs have everything you need to know about using our Payments and Bank account data APIs

View documentation

Need help identifying a payment?

Seen ‘GoCardless Ltd’ on your bank statement? Use our secure tool below to find out more.

Payment Lookup

Need support?

Contact Support

Our support team are available 24/7 to answer any questions you may have.

Quick links

Knowledge base
Visit GoCardless.com

About GoCardless

Legal
Privacy
Security
Blog

Support

Contact support
Complaints
Contact sales

Seen ‘GoCardless Ltd’ on your bank statement?

Identify a payment

GoCardless Inc., 111 Congress Avenue, Suite 500, Austin, TX 78701


GoCardless Inc. (a Delaware Corporation, NMLS ID 2123932), is a FinCEN-registered money services business, registration number 31000261158426, and a licensed money transmitter in certain U.S. states. You can find further information about GoCardless Inc.‘s U.S. licenses and regulators’ contact information here.





English (US) Deutsch English (AU) English (CA) English (GB) English (NZ) Español Français
Search help articles
https://gocardless.com/en-us/partner-with-us/
/hc/theming_assets/01JKARFYGKK1KBMBMT9CC1BV8G
Partner with us
Partner with us to shape the future of payments.
custom
https://gocardless.com/en-us/stories/
/hc/theming_assets/01JKARFYZ7DNZC3PC7YMW92YZ4
Customer Stories
GoCardless helps thousands of businesses with their payments everyday.
custom
https://gocardless.com/payment-lookup/
/hc/theming_assets/01JKARFZAEXTV1RTZ2VZNFPXEW
Identify a payment
If you’ve seen 'GoCardless Ltd' appear on your bank statement
Payment timings, Verification, Xero, 2fa