Acme Citibank Taiwan Payments (H2H)

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

Common DefinitionsCopy Anchor Link

• 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

Citibank restrictionsCopy Anchor Link

• For SWIFT character set: Citibank may reject fields that start with /, -, or :.

Receiver address mapping:Copy Anchor Link

• receiver.address.line1 and receiver.address.line2 each take a dedicated AdrLine slot when present (at most 2 AdrLines).
• Every other field has its own structured field in the bank file: city maps to TwnNm, state to CtrySubDvsn, postalCode to PstCd, and country to Ctry.
• For BKTR, the bank file always sends Ctry as TW regardless of what the client sends; Acme only validates that receiver.address.country is TW when provided.
• Each address field is validated on its own length limit (35 for most fields; 16 for postalCode). Acme does not pack city, state, postal code or country into AdrLines.

BKTRCopy Anchor Link

Book transfer between accounts held at Citibank Taiwan (CITITWTXXXX).

TTCopy Anchor Link

Telegraphic transfer for international payments.

TW_ACHCopy Anchor Link

Taiwan domestic ACH transfer.

TW_RTGSCopy Anchor Link

Taiwan domestic RTGS transfer for high-value payments.

Bank referencesCopy Anchor Link

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"
  }
}