Acme Citibank Brazil Payments

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

Field paths below match batch payloads (payments[N].… per inlined payment).

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  

• Citi restrictions:

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

Supported payment types (Citi Brasil)Copy Anchor Link

BR_BOLETOCopy Anchor Link

BR_UTILITYCopy Anchor Link

BR_TAX_BARCODECopy Anchor Link

BR_DIPHASEDCopy Anchor Link

BR_PIXCopy Anchor Link

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