Bank payment rules

Acme Citibank Australia Payments

This describes validations / allowed data formats for Acme payments going through Citibank Australia. These will be validated by Acme and further validated by the bank. These rules may be stricter than what the bank requires.

Common Definitions

  • SWIFT Character Set:

    • The 26 uppercase Latin letters A-Z
    • The 26 lowercase Latin letters a-z
    • The 10 digits 0-9
    • Forward slash /
    • Hyphen -
    • Question mark ?
    • Colon :
    • Left and right parentheses ( )
    • Full stop .
    • Comma ,
    • Single quote '
    • Plus sign +
    • Space  
  • Citi restrictions:

    • For SWIFT character set: do not start a field with any of the following characters: /, -, :

AU_BECS

fieldpattern / charsetmax lengthmandatory/optional
customerReferenceSWIFT (uppercase only)15M
paymentDetailsSWIFT18O
receiver.nameSWIFT32M
receiver.bankAccountNumberNumeric9M
receiver.localRoutingIdentifierNumeric (6 digit BSB)6M
receiver.address.line1SWIFT35O
receiver.address.line2SWIFT35O
receiver.address.citySWIFT35O
receiver.address.stateSWIFT35O
receiver.address.postalCodeSWIFT16O
receiver.address.countryISO 3166-1 alpha-22O

AU_HVCS

fieldpattern / charsetmax lengthmandatory/optional
customerReferenceSWIFT (uppercase only)16M
paymentDetailsSWIFT140O
bankChargeBearerSENDER or RECEIVER or SHAREDM
receiver.nameSWIFT35M
receiver.bankAccountNumberNumeric9M
receiver.localRoutingIdentifierNumeric (6 digit BSB)6M
receiver.address.line1SWIFT35O
receiver.address.line2SWIFT35O
receiver.address.citySWIFT35Conditional: M if address is provided
receiver.address.stateSWIFT35O
receiver.address.postalCodeSWIFT16O
receiver.address.countryISO 3166-1 alpha-22Conditional: M if address is provided

AU_OSKO

fieldpattern / charsetmax lengthmandatory/optional
customerReferenceSWIFT (uppercase only)15M
paymentDetailsSWIFT18O
receiver.nameSWIFT32M
receiver.bankAccountNumberNumeric9M
receiver.localRoutingIdentifierNumeric (6 digit BSB)6M
receiver.address.line1SWIFT35O
receiver.address.line2SWIFT35O
receiver.address.citySWIFT35O
receiver.address.stateSWIFT35O
receiver.address.postalCodeSWIFT16O
receiver.address.countryISO 3166-1 alpha-22O

TT

fieldpattern / charsetmax lengthmandatory/optional
customerReferenceSWIFT (uppercase only)15M
paymentDetailsSWIFT140O
instructionForSenderBankSWIFT35O
bankChargeBearerSENDER or RECEIVER or SHAREDO
receiver.nameSWIFT35M
receiver.bankAlphanumeric11M
receiver.intermediaryBankAlphanumeric11O
receiver.bankAccountNumberAlphanumeric + Dash34M
receiver.address.line1SWIFT35O
receiver.address.line2SWIFT35O
receiver.address.citySWIFT35Conditional: M if address is provided
receiver.address.stateSWIFT35O
receiver.address.postalCodeSWIFT16O
receiver.address.countryISO 3166-1 alpha-22Conditional: M if address is provided

ACT

fieldpattern / charsetmax lengthmandatory/optional
customerReferenceSWIFT (uppercase only)15M
paymentDetailsSWIFT140O
instructionForSenderBankSWIFT35O
receiver.nameSWIFT35M
receiver.bankAccountNumberAlphanumeric34M
receiver.address.line1SWIFT35O
receiver.address.line2SWIFT35O
receiver.address.citySWIFT35O
receiver.address.stateSWIFT35O
receiver.address.postalCodeSWIFT16O
receiver.address.countryISO 3166-1 alpha-22O

Bank references

bankReference is AcctSvcrRef, else ClrSysRef, from Citi's status report on the payment. bankReferences lists every reference Citi sent, keyed by Citi's field name: AcctSvcrRef, ClrSysRef and StsId, as Citi sends them.

On your Citi statement: the line shows a different Citi reference. Find the payment by your customerReference.

What the names mean:

  • AcctSvcrRef: Citi's own reference for the transaction.
  • ClrSysRef: the clearing system's reference.
  • StsId: the id of Citi's status entry.

A rejected payment keeps the references from the report that rejected it.

A completed payment sent as a file returns:

{
  "bankReference": "01720322200000001",
  "bankReferences": {
    "AcctSvcrRef": "01720322200000001"
  }
}

On this page