Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Airwallex Payouts work
Payout network
AlbaniaAlgeriaAndorraAngolaAnguillaAntigua and BarbudaArgentinaArmeniaArubaAustraliaAustriaAzerbaijanBahrainBangladeshBelgiumBelizeBeninBoliviaBosnia and HerzegovinaBotswanaBrazilBulgariaBurkina FasoCambodiaCameroonCanadaCanary IslandsCentral African RepublicChadChileChinaColombiaCosta RicaCôte d'IvoireCroatiaCuraçaoCyprusCzech RepublicDenmarkDominican RepublicDominicaEcuadorEgyptEl SalvadorEquatorial GuineaEstoniaFaroe IslandsFijiFinlandFranceFrench GuianaFrench PolynesiaFrench Southern TerritoriesGabonGambiaGeorgiaGermanyGibraltarGreeceGreenlandGrenadaGuatemalaGuernseyGuinea-BissauGuyanaHondurasHong Kong SAR
HungaryIcelandIndiaIndonesiaIrelandIsle of ManIsraelItalyJamaicaJapanJerseyJordanKazakhstanKenyaKorea, Republic ofKosovoKuwaitKyrgyzstanLatviaLesothoLiechtensteinLithuaniaLuxembourgMacedonia, the former Yugoslav Republic ofMacao SARMadagascarMalawiMalaysiaMaldivesMaltaMartiniqueMauritaniaMauritiusMayotteMexicoMoldovaMonacoMontenegroMoroccoNamibiaNepalNetherlandsNew CaledoniaNew ZealandNigerNigeriaNorwayOmanPakistanPalestine, State ofPanamaParaguayPeruPhilippinesPolandPortugalPuerto RicoQatarRepublic of the CongoRéunionRomaniaRwandaSaint BarthélemySaint LuciaSaint Martin (French part)Saint Pierre and MiquelonSan MarinoSaudi ArabiaSenegalSerbiaSeychellesSingaporeSlovakiaSloveniaSouth AfricaSpainSri LankaSwedenSwitzerlandTaiwan (China)TajikistanTanzania, United Republic ofThailandTimor-LesteTogoTunisiaTurkeyUgandaUkraineUnited Arab EmiratesUnited KingdomUnited StatesUruguayUzbekistanVanuatuViet NamVirgin Islands (British)Wallis and FutunaZambia
Use cases
Test and go live
Older API versions

Hong Kong SAR

Overview

Transfer methodLocalLocalLocalSWIFT
Local clearing systemACHFPS
(The default LOCAL payout option when local_clearing_system is not specified)
RTGS
Supported currency(ies)HKD, CNYHKD, CNYHKD, CNY, USDAUD, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, NOK, NZD, PLN, RON, SEK, SGD, THB, TRY, USD, ZAR
Payment schemeACHFPSCHATS
Flight time (business days)1-20-10-10-3
Maximum transaction limitNo limit10,000,000 HKDNo limitNo limit
Ultimate payer displayedYesYes

Please refer to the sections below for the key required bank details and other considerations for each supported transfer method.

Local ACH payout

Required fieldsPermitted DataNotes
account_currency3-letter ISO 4217 currency codeOne of HKD, CNY
account_name2-200 charactersAccount holder name of the recipient’s bank account
account_number8-17 digitsThe first 3 digits should be a valid and supported branch code from the bank selected
account_routing_type1bank_code only3-digit number to identify a bank in Hong Kong
account_routing_value13 digits
bank_country_code2-letter ISO 3166-2 country codeShould be HK

Local FPS payout

Required fieldsPermitted DataNotes
account_currency3-letter ISO 4217 currency codeOne of HKD, CNY
account_name2-200 charactersAccount holder name of the recipient’s bank account
account_routing_type1One of bank_code, phone_number, email_address, fps_identifier, or personal_id_numberSee in the table below for definitions
account_routing_value1Definition depends on account_routing_type1; see in the table below
account_number8-17 digitsOnly required when account_routing_type1 is bank_code. The first 3 digits should be a valid and supported branch code from the bank selected
bank_country_code2-letter ISO 3166-2 country codeShould be HK

Coming soon in November 2024 - FPS Proxy ID payouts

When paying HKD or CNY locally via FPS (the Faster Payment System), instead of providing a set of local bank account details for the beneficiary, you can also pay to FPS Proxy IDs registered with local banks. Different types of these account identifiers can be selected by specifying the account_routing_type1 parameter.

See the table below for the supported value options of account_routing_type1, along with their respective information requirement for the account_routing_value1 parameter.

Account routing type 1 valueAccount routing value 1 definitionNote
bank_code
(default value when account_routing_type1 is not specified)
A 3-digit number to identify a bank in Hong Kongbeneficiary.bank_details.account_number is also required. Note that the first 3 digits of the account number should be a valid and supported branch code from the bank selected
phone_numberA phone number in the format of +aaa-nnnnnnnnn as registered with the bank account where:
aaa is an international country calling code up to 3 digits; and
nnnnnnn is a local phone number up to 14 digits. E.g. +852-12345678
Account number is not required when paying to an FPS Proxy ID
email_addressA valid email address as registered with the bank accountAccount number is not required when paying to an FPS Proxy ID
fps_identifierA a 7-digit numerical ID as registered with the bank accountAccount number is not required when paying to an FPS Proxy ID
personal_id_numberThis should be in the format of Xnnnnnn(A) account where:
X stands for 1 or 2 alphabetic letters;
nnnnnn represents a 6-digit number;
A stands for a check digit which can be number 0-9 or the letter A; and the parentheses () are optional
Account number is not required when paying to an FPS Proxy ID

Local RTGS payout

Required fieldsPermitted DataNotes
account_currency3-letter ISO 4217 currency codeOne of HKD, CNY, USD
account_name2-200 charactersAccount holder name of the recipient’s bank account
account_number8-17 digitsThe first 3 digits should be a valid and supported branch code from the bank selected
swift_code8-11 alphanumeric charactersShould be a valid and supported BIC-8 or BIC-11 code
bank_country_code2-letter ISO 3166-2 country codeShould be HK

SWIFT payout

Required fieldsPermitted DataNotes
account_currency3-letter ISO 4217 currency codeOne of AUD, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, NOK, NZD, PLN, RON, SEK, SGD, THB, TRY, USD, ZAR
account_name2-200 charactersAccount holder name of the recipient’s bank account
account_number8-17 digitsThe first 3 digits should be a valid and supported branch code from the bank selected
swift_code8-11 alphanumeric charactersShould be a valid and supported BIC-8 or BIC-11 code
bank_country_code2-letter ISO 3166-2 country codeShould be HK
On this page
  • Overview
  • Local ACH payout
  • Local FPS payout
  • Local RTGS payout
  • SWIFT payout