Search...
APIJSLog inGet started in sandbox
Airwallex logo
Home
Platform APIs
Connected Accounts
Accounts
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewUnderstanding Global Treasury
Market & infrastructure coverage
Use cases
Receive funds
Add funds via direct debits from Linked Accounts
Direct debit schemes and mandate requirements
Australia (AU_BECS_DEBIT)Australia (AU_PAYTO_DEBIT)United States (US_ACH_DEBIT)United States (US_FEDWIRE_DEBIT)United Kingdom (GB_BACS_DEBIT)Europe SEPA (EU_SEPA_DEBIT)Canada (CA_EFT_DEBIT)Hong Kong (HK_FPS_DEBIT)Singapore (SG_EGIRO_DEBIT)New Zealand (NZ_BECS_DEBIT)
Retrieve your depositsDirect debit deposit statusesDirect debit deposit error codesUnderstanding direct debit flight times and funding limits
Receive bank transfers to Global Accounts
Receive via Airwallex Pay
Revenue and fees
Test and go live

New Zealand (NZ_BECS_DEBIT)

Before you begin

Settlement times

nz becs direct debit settlement time

As indicated above, BECS direct debit in New Zealand takes 2-3 business days to settle, depending on submission before/after the cut-off time. Therefore, we recommend leaving some buffer time ahead of the cut-off to avoid delays.

Customers who wish to accelerate the settlement time may apply for our Faster Direct Debit offering, which offers a shortened settlement time of 0-1 business day throughout the day. To enable this capability, please contact your Account Manager and confirm our terms, conditions, and fees.

Mandate requirements

To add funds via BECS direct debit, your customers must first link their New Zealand external bank accounts, as outlined in Linked Accounts.

Before any BECS direct debit is processed, the owner of the external bank account must authorize Airwallex to directly debit the account on your behalf, in compliance with the BECS Direct Debit Scheme Rules. A copy of the authority will be sent by Airwallex via email to the bank account owner, and is stored and made available to be shared with the customer at all times.

The following is a guide to building your native product experience for your customers to link their external bank account and sign the mandate/agreement.

1. Linking an external bank account

The title should clearly inform your customers that they are linking an external bank account to set up direct debit.

You must ask the external bank account owner (or display their previously entered):

  • Bank account name
  • Bank account number
  • Bank account owner email address

2. Confirmation of account details and direct debit authorization

The customers should be given a prompt to confirm that their bank account details are correct before submitting the Linked Bank Account.

There must be a checkbox or a similar mechanism for the external bank account owner to confirm that they have sole authority over the account.

The following text must be displayed:

Direct Debit Authority

I authorize Airwallex (New Zealand) Limited (“Airwallex”) as initiator to debit my account with the amounts of direct debits from NAME OF ACCOUNT with the authorization code AUTH CODE in accordance with this authority until further notice. I agree that this authority will take effect immediately.

I agree that this authority is subject to:

  • The bank's terms and conditions that relate to my account, and
  • The specific terms and conditions listed below.

I may ask my bank to reverse a direct debit up to 9 months after the date the initiator sent the first direct debit under the authority if I am not reasonably satisfied that the authority authorized my bank to debit my account with the amount of the direct debit.

I confirm that I have sole authority over my account. Specific conditions relating to notices and disputes

  • I may ask my bank to reverse a direct debit up to 120 calendar days after the debit if:
  • I don’t receive a written notice of the amount and date of each direct debit from the initiator, or
  • I receive a written notice but the amount or the date of debiting is different from the amount or the date specified on the notice.

The initiator may only send a direct debit if you have:

  • asked the initiator to send it, and
  • agreed the amount of the direct debit.

The initiator is required to give you a written notice of the amount and date of each direct debit no less than the date of the debit.

If the bank dishonours a direct debit but the initiator sends the direct debit again within 5 business days of the dishonour, the initiator is not required to give you a second notice of the amount and date of the direct debit.

3. Confirmation of direct debit set up

It is recommended that you provide a confirmation page to your customers at the end of the process to inform them that direct debit has been successfully set up for the Linked Bank Account.

API instructions

1. Create Linked Account with direct debit mandate

Referring to Linked Account requirements for direct debit, both BUSINESS and INDIVIDUAL Linked Account types are supported for BECS direct debit in New Zealand.

Micro-deposit is available as the verification method. Please follow the instructions in Create a Linked Account using micro-deposit verification and submit the required mandate information under the mandate object.

Example request

Shell

If you are registered as a platform account, you can call this endpoint on behalf of your customers by specifying the open ID in the x-on-behalf-of header.

Example response

JSON

If you already have a Linked Account created using micro-deposit verification, you may call Update a Direct Debit Mandate API to create the mandate.

Example request

Shell

If you are registered as a platform account, you can call this endpoint on behalf of your customers by specifying the open ID in the x-on-behalf-of header.

Example response

JSON

2. Create direct debit deposit

Before creating a direct debit deposit, please ensure that you have a sufficient funding limit by checking your available funding limit.

Next, follow the instructions outlined in Create a direct debit deposit. Please note that the direct debit deposit reference for BECS direct debit should not exceed 12 characters.

Example request

Shell

If you are registered as a platform account, you can call this endpoint on behalf of your customers by specifying the open ID in the x-on-behalf-of header.

Was this page helpful?
On this page
  • Before you begin
  • API instructions
Was this page helpful?