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

Singapore (SG_EGIRO_DEBIT)

Before you begin

Settlement times

Amounts less than or equal to 200,000 SGD settle 24/7 in real-time via the FAST clearing system.

Amounts greater than 200,000 SGD goes through the GIRO network and takes 2-3 business days to settle, depending on the submission time as indicated below.

sgd egiro settlement time

Mandate requirements

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

Before any eGIRO 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 eGIRO Scheme Rules. A copy of the authorization 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 SWIFT code
  • Bank account owner email address
  • Identification type and number (Your customers should be informed that this needs to be the same identification information that was used for registration with the external bank)

2. Confirmation of account details and direct debit authorization

Your customers should 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:

By proceeding with the eGIRO arrangement, you authorize Airwallex (Singapore) Pte. Ltd (“Airwallex”), with its registered office at 1 Wallich St, #20-01 Guoco Tower, Singapore 078881, to debit the bank account specified above through eGIRO for any amount owed for charges arising from your use of the Airwallex Platform and/or pursuant to our terms, and, if necessary, to electronically credit your bank account to correct erroneous debits.

You are entitled to reject Airwallex’s debit instruction if your account does not have sufficient funds, and you authorize Airwallex to charge you a fee if this occurs. Airwallex may, in its discretion, debit your account even if this results in an overdraft. This authorization will remain in force until revoked.

You confirm that you have the authority to link the nominated account.

3. Redirection to eGIRO authorization

After your customer has submitted the Linked Bank Account details, you should redirect them to the URL provided in Generate Linked Account authentication. Your customers are required to log into their respective bank sites and agree to the eGIRO arrangement via the redirect URL.

The banks’ eGIRO setup pages gives your customers the option to set per-transaction limits on direct debit deposits and an expiration date. You are recommended to communicate to your customers that insufficient limits and expiration may impact their experience using your services. The limit/expiration parameters may only be changed by creating a new mandate, through unlinking and relinking the external bank account.

4. 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.

If the external bank account’s authorization process was not immediately completed, you should inform your connected account customer that Direct Debit will be activated upon completion of the external bank account’s authorization flow.

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 eGIRO direct debit in Singapore.

Open Banking is the available verification method, please follow the instructions in Get an open banking authentication token.

Please note that the reference field can only accept alphanumeric characters in all caps without spacing, up to 35 characters long.

Example request

Shell

Example response

JSON

After your customer completes the setup flow on their respective bank sites, you will receive a callback. This callback URL includes auth_id and auth_reference, which are needed in Create Linked Account, together with the required mandate information under the mandate object.

The callback URL will also include a status, possible values are: CLIENT_APPROVED, ABORTED

  • If the status is CLIENT_APPROVED, you should go proceed to create the Linked Account.
  • If the status is ABORTED, it means that the setup was not completed within the expected time.
    • Typically, customers have up to 48 hours to complete the setup on their bank sites.
    • For most BUSINESS bank accounts, a 2-level approval is required, and both approvers are required to complete the setup within the allotted time.

Please follow the instructions in Create a Linked Account using Open Banking verification and submit the required mandate information under the mandate object.

Identification information is compulsory when creating the direct debit mandate for SG_EGIRO_DEBIT. The following must be provided in the identification_document object:

  • type: Type of identification that was used for registration with the external bank.
    • For individual bank accounts, the possible types are FIN, NRIC and PASSPORT
    • For business bank accounts, the possible type is UEN
  • value: Value of the identification

The identification information provided above must also be on file with Airwallex.

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.

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 eGIRO direct debit in Singapore does not support direct debit deposit reference. Instead, a reference, up to 35 characters, must be provided at the mandate level when Creating an Open Banking authentication token API, which will apply to all direct debit deposits initiated from this Linked Account.

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.

Clearing system error codes

To help you handle exceptions systematically, this page provides a comprehensive list of all possible clearing system errors and detailed descriptions when the Linked Accounts or a direct debit deposit from Linked Accounts are in failure statuses.

We recommend using the Airwallex error code or the iso_code for systematic exception handling. The code from provider_failure_details can be used for troubleshooting against the clearing system rules, but it is not advised for systematic handling because the clearing system may update it from time to time.

Direct debit deposit error codes

codeiso codeprovider failure details codedescription
incorrect_account_numberAC01S002, S003, 1010, 1114, 1200The payer’s bank account number is invalid. Please confirm the account number with the payer.
closed_account_numberAC04S008, 1160, 1201The payer’s bank account is closed. Contact the payer to reopen the account, or create a new mandate to charge a different bank account.
not_allowed_amountAM02OD03, S157, S703, 1207The payer sets a limit with its bank and the direct debit deposit amount is greater than the limit.
no_mandateMD01S700, S701, S702, 1041, 1237, 1243The direct debit mandate is not present. Please confirm that the payer or payer's bank has not cancelled the mandate before contacting your account manager for further information.
bank_identifier_incorrectRC01OC04The payer’s SWIFT code is invalid. Please confirm the BIC with the payer.
Was this page helpful?
On this page
  • Before you begin
  • Mandate requirements
  • API Instructions
  • Clearing system error codes
Was this page helpful?