Bank Payment Rules

Every bank and market Acme sends payments to, with the payment types each one supports and a link to its rules.

Each bank guide lists the validations and allowed data formats for Acme payments to that bank. Acme validates every payment against these rules, and the bank validates it again. The rules may be stricter than what the bank requires.

How to read a bank guide

  • Each payment type has its own section, with a table of fields.
  • M is mandatory and O is optional.
  • Conditional (or C) says when the field becomes mandatory.
  • Fields written as payments[N].… belong to each payment in a batch payment. The other fields belong to the batch, or to a single payment.
  • amount is always in minor units. See Minor units format.
  • API: single payments, sent through the bank's API with Create a Payment.
  • H2H: batch payments, sent to the bank as host-to-host files with Create a Batch Payment.
  • API and H2H: the bank takes both. The guide's Channel note lists the payment types that go through the API.
  • Each guide title ends with its channel.

Banks

bankmarketguidechannelpayment types
ANZAustraliaANZ AustraliaH2HAU_BECS, AU_HVCS, AU_OSKO, TT
Banco AztecaMexicoBanco Azteca MexicoAPIMX_SPEI, BKTR
CIMBSingaporeCIMB SingaporeAPIFAST, BKTR, TT
CIMBSingaporeCIMB SingaporeH2HFAST, GIRO, MEPS, TT, BKTR
CitibankSingaporeCitibank SingaporeAPI and H2HFAST, PAYNOW, GIRO, ACT, MEPS, TT
CitibankAustraliaCitibank AustraliaH2HAU_BECS, AU_HVCS, AU_OSKO, TT, ACT
CitibankBrazilCitibank BrazilH2HBR_BOLETO, BR_UTILITY, BR_TAX_BARCODE, BR_DIPHASED, BR_PIX
CitibankChinaCitibank ChinaH2HCN_ACH, CN_RTGS, CN_TT_INTL, CN_TT_DOM
CitibankHong KongCitibank Hong KongH2HHK_FPS_PROXY, HK_FPS_ACCOUNT, HK_CHATS, TT, BKTR
CitibankIndonesiaCitibank IndonesiaH2HID_SKN, ID_FAST, ID_RTGS, TT, BKTR
CitibankIndiaCitibank IndiaH2HIN_RTGS, IN_ACH, IN_IBFT, TT, BKTR
CitibankKoreaCitibank KoreaH2HACT, KR_DFT, TT
CitibankMalaysiaCitibank MalaysiaAPI and H2HMY_IBFT, MY_IBG, MY_DUITNOW, MY_RENTAS, MY_JOMPAY, TT, BKTR
CitibankPhilippinesCitibank PhilippinesH2HPH_PESONET, PH_RTGS, TT, BKTR
CitibankTaiwanCitibank TaiwanH2HTW_ACH, TW_RTGS, TT, BKTR
CitibankUnited StatesCitibank USH2HUS_ACH, US_WIRE_DOM, US_WIRE_INTL, US_RTP
DBSSingaporeDBS SingaporeH2HFAST, PAYNOW, PAYNOW_GIRO, GIRO, ACT, MEPS, TT
DBSSingaporeDBS SingaporeAPIFAST, PAYNOW, ACT, MEPS, TT
Deutsche BankSingaporeDeutsche Bank SingaporeH2HFAST, PAYNOW, GIRO, MEPS, TT
HSBCSingaporeHSBC SingaporeH2HGIRO, FAST, PAYNOW, MEPS, TT
HSBCHong KongHSBC Hong KongAPIHK_FPS_ACCOUNT, HK_CHATS, TT
HSBCHong KongHSBC Hong KongH2HHK_FPS_PROXY, HK_FPS_ACCOUNT, HK_CHATS, HK_ACH, TT
HSBCMalaysiaHSBC MalaysiaAPI and H2HMY_IBG, MY_IBFT, MY_DUITNOW, MY_RENTAS, TT
HSBCVietnamHSBC VietnamH2HVN_NAPAS, VN_RTGS, VN_ACH, TT
MaybankSingaporeMaybank SingaporeH2HFAST, PAYNOW, GIRO, BKTR
OCBCSingaporeOCBC SingaporeAPI and H2HFAST, GIRO, PAYNOW, PAYNOW_GIRO, ACT, MEPS, TT
RHBMalaysiaRHB MalaysiaAPIMY_IBG, MY_IBFT
Standard CharteredSingaporeStandard Chartered SingaporeAPIFAST, MEPS, BKTR, TT
Standard CharteredSingaporeStandard Chartered SingaporeH2HFAST, GIRO, MEPS, SG_PAYROLL, BKTR, TT
Standard CharteredGreat BritainStandard Chartered Great BritainAPIGB_FPS, GB_CHAPS, GB_SEPA, BKTR, TT
Standard CharteredHong KongStandard Chartered Hong KongAPIHK_FPS_PROXY, HK_FPS_ACCOUNT, HK_ACH, HK_CHATS, BKTR, TT
Standard CharteredUAEStandard Chartered UAEAPIUAE_IBFT, UAE_FTS, TT, BKTR
UOBSingaporeUOB SingaporeAPI and H2HFAST, PAYNOW, GIRO, ACT, MEPS, TT
UOBMalaysiaUOB MalaysiaAPI and H2HMY_IBG, MY_IBFT, MY_IAFT, MY_DUITNOW, MY_RENTAS, TT
ZandUAEZand UAEAPIUAE_IBFT, UAE_FTS, TT, BKTR

Purpose code lists

bankmarketlistused in
CitibankIndiaCitibank India Purpose CodespurposeCode on TT
CitibankPhilippinesCitibank Philippines Purpose CodespurposeCode on TT, BKTR
DBSSingaporeDBS Singapore Receiving Party Purpose CodesoutgoingPurposeCode on TT
HSBCHong KongHSBC Hong Kong FPS Purpose CodespurposeCode on HK_FPS_PROXY, HK_FPS_ACCOUNT
Standard CharteredUAEStandard Chartered UAE Purpose of Payment (POP) codespurposeCode on every payment type
UOBSingaporeUOB Singapore Creditor Purpose of Payment CodesoutgoingPurposeCode on TT

On this page