Bank payment rules

Acme Citibank Indonesia Payments

This describes validations / allowed data formats for Acme payments going through Citibank Indonesia. 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: /, -, :

ID_SKN

Important

  • Currency must be IDR only.
  • Amount in Indonesian Rupiah must not have cents / digits after the decimal point (you must send amount ending in 00).
  • Amount maximum 500,000,000 IDR.
fieldpattern / charsetmax lengthmandatory/optional
payments[N].customerReferenceSWIFT (uppercase only)15M
payments[N].paymentDetailsSWIFT140O
payments[N].instructionForSenderBankSWIFT35O
payments[N].receiver.nameSWIFT40M
payments[N].receiver.bankBIC11M
payments[N].receiver.bankAccountNumberAlphanumeric34M
payments[N].receiver.residencyStatusRESIDENT / NON_RESIDENTM
payments[N].receiver.beneficiaryTypeINDIVIDUAL / CORPORATE / GOVERNMENTM
payments[N].receiver.citizenshipStatusCITIZEN / NON_CITIZENM
payments[N].receiver.address.line1SWIFT35O
payments[N].receiver.address.line2SWIFT35O
payments[N].receiver.address.citySWIFT35O
payments[N].receiver.address.stateSWIFT35O
payments[N].receiver.address.postalCodeSWIFT16O
payments[N].receiver.address.countryISO 3166-1 alpha-22O

TT

Important

  • Purpose code (Sandi Tujuan Transaksi) is required. Please contact the bank for the list.
fieldpattern / charsetmax lengthmandatory/optional
payments[N].customerReferenceSWIFT (uppercase only)15M
payments[N].paymentDetailsSWIFT105O
payments[N].instructionForSenderBankSWIFT35O
payments[N].bankChargeBearerSENDER / RECEIVER / SHAREDM
payments[N].purposeCode4 digit purpose code4M
payments[N].receiver.nameSWIFT35M
payments[N].receiver.bankAlphanumeric11M
payments[N].receiver.intermediaryBankAlphanumeric11O
payments[N].receiver.bankAccountNumberAlphanumeric + Dash34M
payments[N].receiver.address.line1SWIFT35O
payments[N].receiver.address.line2SWIFT35O
payments[N].receiver.address.citySWIFT35M
payments[N].receiver.address.stateSWIFT35O
payments[N].receiver.address.postalCodeSWIFT16O
payments[N].receiver.address.countryISO 3166-1 alpha-22M

BKTR

Important

  • Amount in Indonesian Rupiah must not have cents / digits after the decimal point (you must send amount ending in 00).
fieldpattern / charsetmax lengthmandatory/optional
payments[N].customerReferenceSWIFT (uppercase only)15M
payments[N].paymentDetailsSWIFT105O
payments[N].instructionForSenderBankSWIFT35O
payments[N].paymentAdviceEmails[N]Valid email address
Example: ["finance@company.com"]
50 per email (max 1 email)O
payments[N].receiver.nameSWIFT35M
payments[N].receiver.bankAccountNumberAlphanumeric34M
payments[N].receiver.address.line1SWIFT35O
payments[N].receiver.address.line2SWIFT35O
payments[N].receiver.address.citySWIFT35O
payments[N].receiver.address.stateSWIFT35O
payments[N].receiver.address.postalCodeSWIFT16O
payments[N].receiver.address.countryISO 3166-1 alpha-22O

ID_FAST

Important

  • Currency must be IDR only.
  • Amount in Indonesian Rupiah must not have cents / digits after the decimal point (you must send amount ending in 00).
  • Purpose code (Sandi Tujuan Transaksi) is required. Please contact the bank for the list.
fieldpattern / charsetmax lengthmandatory/optional
payments[N].customerReferenceSWIFT (uppercase only)16M
payments[N].paymentDetailsSWIFT140O
payments[N].instructionForSenderBankSWIFT35O
payments[N].bankChargeBearerSENDER / RECEIVER / SHAREDM
payments[N].purposeCode2 digit purpose code2M
payments[N].paymentAdviceEmails[N]Valid email address
Example: ["finance@company.com"]
50 per email (max 1 email)O
payments[N].receiver.nameSWIFT35M
payments[N].receiver.bankAlphanumeric (BIC)11M
payments[N].receiver.bankAccountNumberAlphanumeric34M

ID_RTGS

Important

  • Currency must be IDR only.
  • Amount in Indonesian Rupiah must not have cents / digits after the decimal point (you must send amount ending in 00).
  • Amount mininum > IDR 100,000,000. For amounts ≤ IDR 100,000,000, use ACH Credit/GIRO instead.
fieldpattern / charsetmax lengthmandatory/optional
payments[N].customerReferenceSWIFT (uppercase only)15M
payments[N].paymentDetailsSWIFT105O
payments[N].instructionForSenderBankSWIFT35O
payments[N].bankChargeBearerSENDER / RECEIVER / SHAREDO
payments[N].paymentAdviceEmails[N]Valid email address
Example: ["finance@company.com"]
50 per email (max 1 email)O
payments[N].receiver.nameSWIFT40M
payments[N].receiver.bankAlphanumeric (BIC)11M
payments[N].receiver.bankAccountNumberAlphanumeric34M
payments[N].receiver.localRoutingIdentifierNumeric (7 digits exactly)7M
payments[N].receiver.residencyStatusRESIDENT / NON_RESIDENTM
payments[N].receiver.citizenshipStatusCITIZEN / NON_CITIZENM
payments[N].receiver.bankNameSWIFT35M
payments[N].receiver.address.line1SWIFT35M
payments[N].receiver.address.line2SWIFT35O
payments[N].receiver.address.citySWIFT35M
payments[N].receiver.address.stateSWIFT35O
payments[N].receiver.address.postalCodeSWIFT16O
payments[N].receiver.address.countryISO 3166-1 alpha-22M

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