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

United States (US_FEDWIRE_DEBIT)

Before you begin

Settlement time

Fedwire debits settle on the same day if initiated before the cut-off time of 5:00 PM EST/EDT, hence FASTER_DIRECT_DEBIT is not applicable

Mandate requirements

To add funds via Fedwire direct debit, your customers must first link their United States external bank accounts, as outlined in Linked Accounts.

Before any Fedwire direct debit is processed, the owner of the external bank account must authorize Airwallex to directly debit the account on your behalf with BOTH Airwallex and the paying bank. A copy of the authorization with Airwallex will be sent via email to the bank account owner, and is stored and made available to be shared with the customer at all times.

Each paying bank will have a different process to create a wire drawdown authorization. However in most cases, the paying bank will need the Airwallex’s debit originating bank account information including:

  • Originator Legal Name
  • Originator Financial Institution
  • Originator SWIFT Code
  • Originator ABA Routing Number
  • Originator Bank Account Number
  • Originator Address

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
  • Fedwire routing number
  • Bank account owner's email address

2. Confirmation of account details and direct debit authorization

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

The following text must be displayed on the same confirmation screen:

You authorize Airwallex US, LLC ("Airwallex"), on behalf of AIRWALLEX PLATFORM CUSTOMER, and, if applicable, AIRWALLEX PLATFORM CUSTOMER’s affiliated entities ("Merchant"), to debit the bank account specified above for any amount owed for charges arising from your use of Merchant’s services and/or purchase of products from Merchant, pursuant to Merchant’s terms, and, if necessary, to electronically credit your bank account to correct erroneous debits, until this authorization is revoked. If you use Merchant’s services or purchase additional products periodically, pursuant to Merchant’s terms, you authorize Airwallex to debit your bank account periodically. Payments that fall outside of any regular debits authorized above will only be debited after your authorization is obtained.

If you use Merchant’s services or purchase additional products periodically, pursuant to Merchant’s terms, you authorize Airwallex to debit your bank account periodically. Payments that fall outside of any regular debits authorized above will only be debited after your authorization is obtained.

You may amend or cancel this authorization at any time by providing 30 (thirty) days' notice to Airwallex prior to the scheduled debit. You may provide such notice to Airwallex by contacting [email protected].

You must also instruct the external bank account owner to create a wire drawdown authorization with their bank using Airwallex’s debit originating bank account information, thereby allowing Fedwire debits to be accepted.

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, only BUSINESS Linked Account type is supported for Fedwire direct debit in the United States.

Micro-deposit is available as the verification method. Please follow the instructions in Create a Linked Account using micro-deposit verification and submit the following 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

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 Fedwire direct debit should not exceed 140 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
  • Mandate requirements
  • API instructions
Was this page helpful?