Pain, Ach, CTX and Nacha
Pain, Ach, CTX and Nacha
Pain, Ach, CTX and Nacha
Transaction Guide to
Mapping U.S. ACH File
Formats – CCD, CTX, PPD and
Outbound IAT
November 2016
Version 3.0
Acknowledgements
This document was developed and updated by Nasreen Quibria of Q INSIGHTS for NACHA-The
Electronic Payments Association. Thanks to the following financial institutions and other key
stakeholders for providing insights that were applied in the creation of one or more of the
NACHA ISO 20022 Mapping Guides and Spreadsheets:
ACI Worldwide
Bank of America
Bayer
BBVA Compass
BNY Mellon
BOK Financial
Bottomline Technologies
Citi
Commerzbank
Deutsche Bank
DNB
Fifth Third Bank
IBM
JPMorgan Chase
Microsoft
PNC
Oracle
SAP
US Bank
Wells Fargo
2|Page
Table of Contents
1. Overview ................................................................................................................................ 5
2. Payment Initiation (pain.001) Credit Transfer File Structure and Content ..................... 6
a. Parties of the Transaction ................................................................................................. 6
b. Scenario .............................................................................................................................. 7
c. pain.001 XML Payment Message File Structure ............................................................. 8
1) The Group Header ......................................................................................................... 9
2) Payment Information..................................................................................................... 9
3) Credit Transfer Transaction Information ...................................................................... 9
a) Remittance Information ............................................................................................ 9
d. U.S. ACH Payments .......................................................................................................... 10
e. Examples of U.S. ACH Payments ................................................................................... 11
f. ISO File Format Table ....................................................................................................... 17
1) The Group Header ....................................................................................................... 19
2) Payment Information................................................................................................... 22
3) Credit Transfer Transaction Information .................................................................... 33
3. NACHA File Mapping Details ............................................................................................. 62
a. File Header Record – All Formats................................................................................... 62
b. Company/Batch Header Record – All SECs Except IAT ............................................ 64
c. Company/Batch Header Record – IAT Only (Outbound Payments) ...................... 66
d. CCD or PPD Entry Detail Record ................................................................................... 69
e. CTX Entry Detail Record .................................................................................................. 71
f. IAT Entry Detail Record (Outbound Payments) ........................................................... 73
g. CCD Addenda Record (Optional) ............................................................................... 75
h. CTX Addenda Record (Optional) ................................................................................. 76
i. IAT First Addenda Record (710) (Outbound Payments) ............................................ 77
j. IAT Second Addenda Record (711) (Outbound Payments) ..................................... 79
k. IAT Third Addenda Record (712) (Outbound Payments) .......................................... 80
l. IAT Fourth Addenda Record (713) (Outbound Payments)........................................ 81
m. IAT Fifth Addenda Record (714) (Outbound Payments) ........................................ 82
3|Page
n. IAT Sixth Addenda Record (715) (Outbound Payments) ........................................... 83
o. IAT Seventh Addenda Record (716) (Outbound Payments) .................................... 84
p. IAT Addenda Record for Remittance Information (717) (Optional) (Outbound
Payments) ................................................................................................................................ 85
q. IAT Addenda Record for Foreign Correspondent Bank Information (718)
(Outbound Payments) ........................................................................................................... 86
r. Batch/Control Record – All Formats ............................................................................. 88
s. File Control Record – All Formats ................................................................................... 90
4. Remittance Information ..................................................................................................... 91
a. CCD Addenda – NACHA Endorsed Banking Conventions for TXP, DED, and TPP
Payments ................................................................................................................................. 91
1) Unstructured ................................................................................................................. 92
2) Structured...................................................................................................................... 93
b. CTX Addenda .................................................................................................................. 98
1) Structured Data – STP 820 (EDI) .................................................................................. 99
2) Comparison of ISO 20022 XML Syntax with STP 820 ............................................... 101
3) DED .............................................................................................................................. 103
c. IAT Addenda .................................................................................................................. 103
5. Same Day ACH .................................................................................................................. 104
6. Exceptions – Returns and Rejects ................................................................................... 105
7. Appendix ............................................................................................................................ 106
a. The Character Set ......................................................................................................... 106
1) Basic Latin ................................................................................................................... 106
2) Special Characters in XML Content ........................................................................ 107
b. ISO Country Codes ........................................................................................................ 108
c. External Code List .......................................................................................................... 108
d. Related Resources......................................................................................................... 108
1) ISO 20022 ..................................................................................................................... 108
2) Common Global Implementation – Market Practice (CGI-MP) ......................... 108
3) European Payments Council (EPC) Guidelines for SEPA Transactions ............... 109
8. Revision History................................................................................................................... 110
4|Page
1. Overview
NACHA aims to provide guidance on the use of ISO 20022 applied to U.S. ACH formats. This
document describes and references NACHA’s recommended interpretations and guidelines
to follow when mapping the ISO 20022 payment initiation message to U.S. ACH Standard
Entry Class Codes: CCD, CTX, PPD, and Outbound IAT.
The format of the file to be used to submit Payment Instructions is part of the Payment
Initiation (PAIN) suite. For credit transactions, the specific format is called pain.001. The
version recommended by NACHA for use of these formats is pain.001.001.03 in alignment
with the Single Euro Payment Area (SEPA) implementation guideline put forth by the
European Payments Council (EPC) and the current and future trend in global adoptions of
ISO 20022 standards. With this, NACHA desires to maximize global interoperability for U.S.
based companies.
This document should be read alongside the NACHA pain.001 ISO 20022 Mapping
Spreadsheet, which offers the full set of data elements and sub elements in the pain.001 XML
file. Knowledge of XML and NACHA rules and formats is recommended to interpret this
document.
This guide is intended for educational purposes only and does not constitute legal advice. It may be
updated as the needs of the industry evolve. Users are encouraged to periodically ensure they have
the most current version.
5|Page
2. Payment Initiation (pain.001) Credit Transfer File Structure and
Content
6|Page
b. Scenario
The purpose of this section is to provide the entire chain of electronic information
exchange between the Debtor, the Debtor’s Agent, the Creditor’s Agent and the
Creditor. The high level process flow is illustrated below.
pacs messages
Customer Payment
Account Reporting
Account Reporting
Status Report
Status Report
pain.001 pain.008
Purchase
Invoice
*NOTE: RDFI / ODFI and Originator / Receiver are reversed when pain.008 is originated
1. The Debtor (Originator) receives an invoice for a purchase that they made.
2. The Debtor creates the payment instruction, a Credit Transfer Initiation (pain.001) file
that is sent to the Financial Institution, the Debtor Agent (or ODFI).
3. The Debtor Agent validates the message and sends a Payment Status Report
(pain.002) notifying the Debtor if the file is accepted or rejected.
4. The information included in every single payment is validated against each payment
system and the Debtor Agent sends a Payment Status Report (pain.002) reporting
rejected payments to the Debtor, if any.
5. Once a file is transmitted via the clearing house to the Creditor Agent (or RDFI), the
Debtor Agent will send a Debit Notification report (camt.054) to the Debtor reporting
executed payments.
6. The Creditor Agent sends a Credit Notification report (camt.054) to the Creditor
reporting incoming payments.
7. Debtor Agent and/or Creditor Agent sends an Interim Account Report (camt.052) to
the Debtor and/or Creditor.
8. Debtor Agent and/or Creditor Agent sends an Account Statement (camt.053) to the
Debtor and/or Creditor.
7|Page
Note that this document is limited to pain.001 message transactions and does not
address pain.002 or the camt messages described above.
Credit Transfer
Transaction
Information (1..n)
Remittance
Information (0..1)
The message may contain several Payment Information parts to which one or several
Credit Transfer Transaction Information parts are included.
8|Page
1) The Group Header
The Group Header is mandatory and must be present once. It is the set of
characteristics shared by all individual transactions included in the message, and
used to identify the file. It contains the common identifying elements: Message
Identification, Creation Date and Time, Authorisation, Number of Transactions,
Control Sum, Initiating Party, and Forwarding Agent.
2) Payment Information
The Payment Information is mandatory and can be present more than once. It
provides the set of details of the message between the (ultimate) debtor and the
(ultimate) creditor. It also represents a logical grouping of payments. The
information can include such elements as Debtor, Debtor Account, Payment
Type Information, Payment Method, and Requested Execution Date for the
transactions contained in the block.
a) Remittance Information
Please refer to the Remittance section (Part 4) of this document for more
detailed information on how to handle remittance information for the
different SEC Codes.
9|Page
d. U.S. ACH Payments
Today it is not possible to transmit ISO 20022 XML files through the U.S. clearing systems
(Operators). As such, U.S. financial institutions that receive ISO 20022 XML-based files
must translate these to NACHA file formats. The financial institutions that translate the
ISO 20022 payment instruction files feed into an existing process flow. It is general
practice for the banks to populate standard “formatting” fields (e.g., record type
codes, record size, etc. highlighted in Part 3 of this document) based on the NACHA
Operating Rules. All customer-specific information is populated from the XML file or
Setup process. Otherwise, the fields are being populated during the creation of the
NACHA file by the ODFI system (e.g., Entry Hash, Entry/Addenda Count) based on
accepted transactions.
pain.001
Purchase
Invoice
As multiple payment types such as wires, ACH, and checks may be transmitted within
a credit transfer payment instruction (pain.001) file, for U.S. ACH payments, it is
important to take note of the guidance outlined in the following.
10 | P a g e
e. Examples of U.S. ACH Payments
Immediate Origin (10-digit company number assigned by bank e.g., Tax ID): 1234567891
File Creation Date: February 14, 2015
File Creation Time: 11:35
Immediate Origin Name (Originator): ABC Company
1 2 3 4 5 6 7 8 9
1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234
Example Data
101 987654321123456789115021411351094101USA BANK ABC Company
The 10-digit U.S. company number assigned by the financial institution may be further defined by including the
identification of the scheme name such as Tax ID or Employer Identification Number. However, this is not required.
Note that other details of the record file are left out of this example.
11 | P a g e
Group Header XML Message
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<CstmrCdtTrfInitn>
<GrpHdr>
<CreDtTm>2015-02-14T11:35:01</CreDtTm>
File Creation Date + File Creation Time
<InitgPty>
<Nm>ABC Company</Nm>
Immediate Origin Name
<Id>
<OrgId>
<Othr>
<Id>1234567891</Id>
Immediate Origin
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</InitgPty>
</GrpHdr>
12 | P a g e
Figure 5: NACHA File Format
1 2 3 4 5 6 7 8 9
12345678901234567890123456789012345678901234567890123456789012345678901234567890012345678901234
Example Data
5200ABHC CLM PMT CR 1234567891CCDHCCLAIMPMT 1502190001987654320000014
The payment method should be set to “TRF” for credit transactions and Service Level to “NURG,” or non-urgent
payment. Additionally, the local instrument code is used to identify the Standard Entry Class Code. In U.S. ACH
transactions, a routing number or ABA consisting of 9 digits is mandatory. The ABA corresponds to the clearing number,
and is used to identify the correct agent (or bank). As such, “USABA” must be entered before the ABA. Note that other
details of the record file are left out of this example.
13 | P a g e
Company Name <Dbtr>
<Nm>ABHC CLM PMT CR</Nm>
<Id>
<OrgId>
<Othr>
Company Identification <Id>1234567891</Id>
</Othr>
</OrgId>
</Id>
</Dbtr>
<DbtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>USABA</Cd>
</ClrSysId>
Originating DFI Identification <MmbId>987654321</MmbId>
</ClrSysMmbId>
<Nm>USA BANK</Nm>
</FinInstnId>
</DbtrAgt>
</PmtInf>
14 | P a g e
Figure 6: NACHA File Format
1 2 3 4 5 6 7 8 9
12345678901234567890123456789012345678901234567890123456789012345678901234567890012345678901234
Example Data
6221110000254854697999999 0000010000HowserMD1234567DoogieHowserFamilyPrac 1987654320000904
As previously noted, the ABA corresponds to the clearing number, and is used to identify the correct agent (or bank).
As such, “USABA” must be entered before the ABA. The name of the creditor (receiver) can be entered with a
maximum of 22 characters when making an ACH payment. The creditor account number (DFI account number) must
be entered with 1-17 characters. Note that other details of the record file are left out of this example.
<CdtrAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>USABA</Cd>
</ClrSysId>
Receiving DFI Identification + Check Digit <MmbId>111000025</MmbId>
</ClrSysMmbId>
<Nm>AMERICA BANK</Nm>
15 | P a g e
<PstlAdr>
<Ctry>US</Ctry>
<PstlAdr>
</FinInstnId>
</CdtrAgt>
<Cdtr>
Receiving Company Name <Nm>DoogieHowserFamilyPrac</Nm>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>4854697999999</Id>
DFI Account Number </Othr>
</Id>
</CdtrAcct>
</CdtTrfTxInf>
16 | P a g e
f. ISO File Format Table
The payment initiation credit transfer message is described in the following table and
shows how these blocks are to be coded within the actual XML file. Mandatory ISO
20022 fields and key data elements required to map to NACHA file formats are
highlighted. Please pay attention to the column "Maps to NACHA Format Field" when
implementing support for credit transfer files for the U.S. market. Failure to provide files
that meet the specifications outlined may result in files and/or transactions being
rejected.
Note that not all elements have been repeated in this document and should be
taken into account where applicable in bank specific criteria.
ISO Index: index used in the official ISO 20022 XML Message Definition Report
(www.iso20022.org)
Tag Level: specifies the tag depth of the ISO field name within the document
represented by a ‘+’. For example:
‘++’ would represent the Child Element of the previous Parent Element
+ <>
++ <>
<>
+++ <>
<>
<>
G DTH TAG STRUCTURE
Note that where optional tags that have not been populated, the tag should
be omitted from the file along with its parent tag. Also, “empty tag” implies a
choice component.
17 | P a g e
M or O: specifies whether each tag and data element is mandatory or
optional
Maps to NACHA Format Field: specifies whether each tag and data element
is applicable to NACHA SEC Code CCD, CTX, PPD, or Outbound IAT
Mapping Guide: For a number of fields, please pay attention to the Usage
Rules that must be followed when implementing pain.001 credit transactions
files sent in the U.S. These are outlined throughout the document.
18 | P a g e
1) The Group Header
Group Header contains the identification information of the payment message.
XML Declaration
Set of characteristics
shared by all individual
Group Header transactions included in
1.0 + [1..1] M
<GrpHdr> the message
Empty tag
Unique identification, as
assigned by the initiating
party, and sent to the
Message next party in the chain
Max35Text
1.1 Identification ++ to unambiguously [1..1] M
<MsgId> identify the message
19 | P a g e
Group Header Block
Empty tag
Unique an unambiguous
Organisation way of identifying an
9.1.13
Identification ++++ organisation [1..1] M
{OR
<OrgId>
Empty tag
20 | P a g e
Group Header Block
Empty tag
10-digit company number assigned by
Identification assigned ALL, File Header Record,
Identification Max35Text bank typically 9-digit tax ID preceded by
9.1.16 ++++++ by an institution [1..1] M Immediate Origin (Record
<Id> "1"
1, Field 4)
Name of the
9.1.17 Scheme Name ++++++ identification scheme [0..1]
O
<SchmeNm>
Empty tag
May include as part of File Header Record,
Name of the Immediate Origin (Record 1, Field 4)
identification scheme, in
9.1.18 Code +++++++ [1..1] Code
a coded form as M Set to: (Examples):
{OR <Cd>
published in an external “TXID” for Tax Identification Number
list “CUST” Customer Identification Number
or other Code from External Code List
Name of the
9.1.19 Proprietary +++++++ [1..1] Max35Text Usage Rule: If <Cd> is populated, <Prtry>
identification scheme, in M
OR} <Prtry> should not be populated
a free text form
Identification of a
9.1.21 Private Identification private person Usage Rule: If <OrgId> is populated,
++++ [1..1] M
OR} <PrvtId> <PrvtId> should not be populated
Empty tag
21 | P a g e
2) Payment Information
Payment Information contains elements related to the debit side of the transaction. The information is common to all
the credit transfers attached to this Payment Information.
Empty tag
1. For CCD, PPD and CTX,
Batch Header Record,
Batch Number (Record 5,
Field 13) Originator assigns batch numbers in
Payment Information Originator’s unique
Max35Text 2. For IAT, Batch Header ascending order within each file
2.1 Identification ++ identifier of the batch of [1..1] M
Record, Batch Number
<PmtInfId> transactions
(Record 5, Field 17) May vary by bank and set by ODFI system
3. For ALL, Batch Control
Record, Batch Number
(Record 8, Field 11)
Specifies the means of
Payment Method payment that will be
2.2 ++ [1..1] Code M Set to “TRF” for Credit Transfers
<PmtMtd> used to move the
amount of money
Total number of
Number Of Max15 If all transactions are accepted would
individual transactions
2.4 Transactions ++ [0..1] NumericTex O equal to the Entry Count in the batch (All
contained in the
<NbOfTxs> “6” records)
message
Total of all individual If all transactions are accepted, would
amounts included Quantity
Control Sum equal Total Credit Entry Dollar Amount in
2.5 ++ in the batch [0..1] [Decimal O
<CtrlSum> the batch
(sum of Instructed Number]
Amount)
22 | P a g e
Payment Information Block – This can occur multiple times
Empty tag
Specifies a pre-agreed
service or level of service
2.9 Code Set to “NURG” for payment executed as
++++ between the parties, as [1..1] Code M
{OR <Cd> non-urgent payment
published in an external
service level code list
Specifies a pre-agreed
2.10 Proprietary service or level of service Max35Text Usage Rule: If <Cd> is populated, <Prtry>
++++ [1..1] M
OR} <Prtry> between the parties, as should not be populated
a proprietary code
User community specific
Local Instrument instrument
2.11 +++ [0..1] O
<LclInstrm>
Empty tag
1. For CCD/CCD+, set Local Instrument
1. For CCD , PPD and CTX, Code value to "CCD"
Batch Header Record, For PPD/PPD+, set Local Instrument Code
Specifies the local Standard Entry Class value to "PPD"
2.12 Code instrument as published Code (Record 5, Field 6) For CTX, set Local Instrument Code value
++++ [1..1] Code M
{OR <Cd> in an external local 2. For IAT, Batch Header to " CTX"
instrument code list Record, Standard Entry 2. For IAT, set Local Instrument Code value
Class Code (Record 5, to " IAT"
Field 9)
23 | P a g e
Payment Information Block – This can occur multiple times
Empty tag
Category purpose, as
published in an external
2.15 Code Usage Rule: If <Prtry> is populated, <Cd>
++++ category purpose code [1..1] Code M
{OR <Cd> should not be populated
list
24 | P a g e
Payment Information Block – This can occur multiple times
25 | P a g e
Payment Information Block – This can occur multiple times within a file
Empty tag
26 | P a g e
Payment Information Block – This can occur multiple times within a file
Empty Tag
1. For CCD, PPD & CTX,
Batch Header Record,
Company Identification
(Record 5, Field 5)
2. For IAT, Batch Header
Identification Identification assigned Max35Text Record, Originator 10-digit ID assigned by the bank
9.1.16 ++++++ [1..1] M
<Id> by an institution Identification (Record 5,
Field 8)
3. For ALL, Batch Control
Record, Company
Identification (Record 8,
Field 7)
Name of the
9.1.17 Scheme Name ++++++ identification scheme [0..1]
O
<SchmeNm>
Empty tag
27 | P a g e
Payment Information Block – This can occur multiple times within a file
28 | P a g e
Payment Information Block – This can occur multiple times within a file
Empty tag
Bank Identifier Code.
Code allocated to
financial institutions by
the Registration
Authority, under an
international
BIC identification scheme, as BICIdentifier Usage Rule: Either <BIC> or <ClrSysMmbId>
6.1.1 ++++ [0..1] O
<BIC> described in the latest must be populated
version of the standard
ISO 9362 Banking
(Banking
telecommunication
messages, Bank Identifier
Codes)
Unique and
unambiguous identifier
Clearing System of a clearing system
Member member, as assigned by
6.1.2 ++++ [0..1] O
Identification the system or system
<ClrSysMmbId> administrator.
Empty tag
Specification of a pre-
agreed offering
between clearing
Clearing System agents or the channel
6.1.3 Identification +++++ through which the [0..1] O
<ClrSysId> payment instruction is
processed
Empty tag
29 | P a g e
Payment Information Block – This can occur multiple times within a file
30 | P a g e
Payment Information Block – This can occur multiple times within a file
Identification of a
Department Max70Text
6.1.10 +++++ division of a large [0..1] O
<Dept>
organisation or
building
Identification of a sub-
6.1.11 Sub Department Max70Text
+++++ division of a large [0..1] O
<SubDept>
organisation or building
31 | P a g e
Payment Information Block – This can occur multiple times within a file
32 | P a g e
3) Credit Transfer Transaction Information
Credit Transfer Transaction Information contains elements related to the transaction.
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Set of elements to
Payment reference a payment
2.28 Identification +++ instruction. [1..1] M
<PmtId>
Empty tag
Unique identification as
assigned by an
instructing party for an
Instruction Usage Rule: If present, ID to be returned
instructed
2.29 Identification ++++ [0..1] Text O only to the originating party in account
party to unambiguously
<InstrId> statement reporting
identify the instruction. It
is not forwarded to the
creditor’s bank
1. For CCD, PPD and CTX ,
Originator’s Reference
Entry Detail Record,
to the Credit Transfer
Identification Number
to unambiguously
End To End (Record 6, Field 7) Usage rule: Payment Reference that goes
identify the transaction.
2.30 Identification ++++ [1..1] Text M 2. For IAT, Sixth IAT with the payment from debtor to creditor
This identification is
<EndToEndId> Addenda Record, and travels throughout the clearing system
passed on, unchanged,
Receiver Identification
throughout the entire
Number (Record 7,
end-to-end chain
Field 3)
Payment Type Information This is optional and if used, it is recommended to be used at Payment Information level and not at Credit Transfer Transaction Information level. However, if
‘Instruction Priority’ is populated this field group must be present at ‘Payment Information’ level and not at transaction information level.
Set of elements that
Payment Type further specifies the type
2.31 Information +++ of transaction [0..1] O
<PmtTpInf>
Empty tag
33 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Specifies a pre-agreed
service or level of service
2.34 Code Set to “NURG” for payment executed as
+++++ between the parties, as [1..1] Code M
{OR <Cd> non-urgent payment
published in an external
service level code list
Specifies a pre-agreed
2.35 Proprietary service or level of service Max35Text Usage Rule: If <Cd> is populated, <Prtry>
+++++ [1..1] M
OR} <Prtry> between the parties, as should not be populated
a proprietary code
User community specific
Local Instrument instrument
2.36 ++++ [0..1] O
<LclInstrm>
Empty tag
1. For CCD, PPD and CTX, 1. For CCD/CCD+, set Local Instrument
Batch Header Record, Code value to "PPD"
Specifies the local Standard Entry Class For PPD/PPD+, set Local Instrument Code
2.37 Code instrument as published Code (Record 5, Field 6) value to "PPD"
+++++ [1..1] Code M For CTX, set Local Instrument Code value
{OR <Cd> in an external local 2. For IAT, Batch Header
instrument code list Record, Standard Entry to "CTX"
Class Code (Record 5, 2. For IAT, set Local Instrument Code value
Field 9) to “IAT"
Empty tag
Specifies Category
2.40 Code purpose as published in Usage Rule: If <Prtry> is populated, <Cd>
+++++ [1..1] Code M
{OR <Cd> an external category should not be populated
purpose code list
34 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
35 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
1. For IAT, Batch Header
The factor used for
Record, Foreign 1. If <ExchangeRate> present, set Foreign
conversion of an
Exchange Reference Exchange Reference Indicator to “1”
amount from one
Indicator (Record 5, Field 1 & 2. If neither <ExchangeRate> nor
Exchange Rate currency to another. This
2.48 ++++ [0..1] Rate O 5) <ContractIdentification> are present, set
<XchgRate> reflects the price at
2. For IAT, Batch Header Foreign Exchange Reference Indicator to
which one currency was
Record, Foreign “3” and Foreign Exchange Reference
bought with another
Exchange Reference should be set to blank
currency
(Record 5, Field 6)
Usage Rule: If Code AGRD (Exchange rate
applied is the rate agreed with the bank) is
used then a valid contract number must be
Specifies the type used
Rate Type filled in tag 2.50
2.49 ++++ to complete the [0..1] Code O
<RateTp>
currency exchange
Other values for <Rate Type>:
"SALE" = market rate at the time of the sale
"SPOT” = spot rate
36 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Bank Identifier Code.
Code allocated to
financial institutions by
the Registration
Authority, under an
international
BIC identification scheme, as BICIdentifier
6.1.1 +++++ [0..1] O
<BIC> described in the latest
version of the standard
ISO 9362 Banking
(Banking
telecommunication
messages, Bank Identifier
Codes)
37 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Specification of a pre-
agreed offering
between clearing
Clearing System agents or the channel
6.1.3 Identification ++++++ through which the [0..1] O
<ClrSysId> payment instruction is
processed
Empty tag
Identification of a
Set to “USABA”
6.1.4 Code clearing system in a
+++++++ [1..1] Code M
{OR <Cd> coded form as published
in an external list
Identification code for a
clearing system that has
6.1.5 Proprietary Max35Text Usage Rule: If <Cd> is populated,
+++++++ not yet been identified [1..1] M
OR} <Prtry> <Prtry> should not be populated
in the list of clearing
systems
1. For IAT, Entry Detail
Record, Gateway
Member Identification of a Operator (GO) Note that Field 3 and 4 are combined for
Identification member of a clearing Max35Text Identification (Record 6 , Record 6 as the Check Digit is the last (or
6.1.6 ++++++ [1..1] M
<MmbId> system Field 3) 9th) digit of the transit routing number
2. For IAT, Entry Detail
Record, Check Digit
(Record 6 , Field 4)
Agent between the
debtor agent and
Intermediary Agent2
2.73 +++ creditor agent [0..1] O
<IntrmyAgt2>
Empty tag
38 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Bank Identifier Code.
Code allocated to 1. For IAT, Addenda For
financial institutions by Foreign Correspondent
the Registration Bank Information
Authority, under an (Record 7, Field 4)
international 2. For IAT, Addenda Record
If <BIC> is present, set Foreign
BIC identification scheme, as BICIdentifier For Foreign
6.1.1 +++++ [0..1] O Correspondent Bank Identification Number
<BIC> described in the latest Correspondent Bank
Qualifier to “02”
version of the standard Information, Foreign
ISO 9362 Banking Correspondent Bank
(Banking Identification Number
telecommunication (Record 7, Field 5)
messages, Bank Identifier
Codes)
Unique and
unambiguous identifier
Clearing System of a clearing system
Member member, as assigned by
6.1.2 +++++ [0..1] O
Identification the system or system
<ClrSysMmbId> administrator
Empty tag
Specification of a pre-
agreed offering
between clearing
Clearing System agents or the channel
6.1.3 Identification ++++++ through which the [0..1] O
<ClrSysId> payment instruction is
processed
Empty tag
39 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
40 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Identifies a subdivision of
Country Sub Division Max35Text
6.1.16 ++++++ a country e.g., state, [0..1] O
<CtrySubDvsn>
region, country
41 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
1. For IAT, Addenda For
Foreign Correspondent
Bank Information,
Foreign Correspondent
International Bank
Bank Identification
Account Number (IBAN)
Number Qualifier
- identifier used
1.1.1 IBAN (Record 7, Field 4) If <Cd> is present, set Foreign
+++++ internationally by [1..1] Identifier M
{OR <IBAN> 2. For IAT, Addenda Record Correspondent Bank Identification Number
financial institutions to
For Foreign Qualifier to “03”
uniquely identify the
Correspondent Bank
account of a customer
Information, Foreign
Correspondent Bank
Identification Number
(Record 7, Field 5)
42 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Bank Identifier Code.
Code allocated to 1. For IAT, Addenda
financial institutions by Record for Foreign
the Registration Correspondent Bank
Authority, under an Information Record
international (Record 7, Field 4)
If <BIC> is present, set Foreign
BIC identification scheme, as BICIdentifier 2. For IAT, Addenda
6.1.1 +++++ [0..1] O Correspondent Bank Identification Number
<BIC> described in the latest Record For Foreign
Qualifier to “02”
version of the standard Correspondent Bank
ISO 9362 Banking Information, Foreign
(Banking Correspondent Bank
telecommunication Identification Number
messages, Bank Identifier (Record 7, Field 5)
Codes)
Unique and
unambiguous identifier
Clearing System of a clearing system
Member member, as assigned by
6.1.2 +++++ [0..1] O
Identification the system or system
<ClrSysMmbId> administrator
Empty tag
43 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
For IAT, Addenda Record
Identification of a for Foreign Correspondent
6.1.4 Code clearing system, in a Bank Information, Foreign
+++++++ [1..1] Code M If <Cd> is present, set Foreign
{OR <Cd> coded form as published Correspondent Bank
Correspondent Bank Identification Number
in an external list Identification Number
Qualifier to “01”
Qualifier (Record 7, Field 4)
Identification code for a
clearing system, that has
6.1.5 Proprietary Max35Text Usage Rule: If <Cd> is populated,
+++++++ not yet been identified [1..1] M
OR} <Prtry> <Prtry> should not be populated
in the list of clearing
systems
For IAT, Addenda Record
Member Identification of a for Foreign Correspondent May map to <IntermediaryAgent2> or
Identification member of a clearing Max35Text Bank Information, Foreign <IntermediaryAgent3>
6.1.6 ++++++ [1..1] M
<MmbId> system Correspondent Bank <MemberIdentification> to Foreign
Identification Number Correspondent Bank Identification Number
(Record 7, Field 5)
For IAT, Addenda Record
Name by which a party
for Foreign Correspondent May map <IntermediaryAgent2> or
Name is known and which is Max140Text
6.1.7 +++++ [0..1] O Bank Information, Foreign <IntermediaryAgent3><Name> to Foreign
<Nm> usually used to identify
Correspondent Bank Name Correspondent Bank Name
that party
(Record 7, Field 3)
44 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Identifies a subdivision of
Country Sub Division Max35Text
6.1.16 ++++++ a country e.g., state, [0..1] O
<CtrySubDvsn>
region, country
45 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
1. For IAT, Addenda For
Foreign Correspondent
Bank Information,
Foreign Correspondent
International Bank
Bank Identification
Account Number (IBAN)
Number Qualifier
- identifier used
1.1.1 IBAN (Record 7, Field 4) If <Cd> is present, set Foreign
+++++ internationally by [1..1] Identifier M
{OR <IBAN> 2. For IAT, Addenda Record Correspondent Bank Identification Number
financial institutions to
For Foreign Qualifier to “03”
uniquely identify the
Correspondent Bank
account of a customer
Information, Foreign
Correspondent Bank
Identification Number
(Record 7, Field 5)
46 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Bank Identifier Code.
Code allocated to
1. For IAT, Fifth IAT
financial institutions by
Addenda Record,
the Registration
Receiving DFI
Authority, under an
Identification Number
international
Qualifier (Record 7, Field
BIC identification scheme, as BICIdentifier If <BIC> is present, set Receiving DFI
6.1.1 +++++ [0..1] O 4)
<BIC> described in the latest Identification Number Qualifier to “02”
2. For IAT, Fifth IAT
version of the standard
Addenda Record,
ISO 9362 Banking
Receiving DFI
(Banking
Identification Number
telecommunication
(Record 7, Field 5)
messages, Bank Identifier
Codes)
Unique and
unambiguous identifier
Clearing System
of a clearing system
Member
6.1.2 +++++ member, as assigned by [0..1] O
Identification
the system or system
<ClrSysMmbId>
administrator
Empty tag
47 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Specifies the Clearing
For IAT, Fifth IAT Addenda
System Member
6.1.4 Code Record, Receiving DFI If <Cd> is present, set Receiving DFI
+++++ Identification as [1..1] Code M
{OR <Cd> Identification Number Identification Number Qualifier to “01”
published in an external
Qualifier (Record 7, Field 4)
local instrument code list
Specifies the Clearing
6.1.5 Proprietary System Member Usage Rule: If <Cd> is populated,
+++++ [1..1] Max35Text M
OR} <Prtry> Identification as a <Prtry> should not be populated
proprietary code
1. For CCD, PPD &CTX, Entry
Detail Record, Receiving
1. The first 8 digits of <MemberIdentification>
DFI Identification (Record
map to the Receiving DFI Identification
6 , Field 3)
Member 2. Note that Field 3 and 4 are combined for
2. For CCD, PPD & CTX, Entry
Identification Bank clearing code or Record 6 as the Check Digit is the last (or
6.1.6 ++++++ [1..1] Max35Text M Detail Record, Check
<MmbId> transit routing number 9th) digit of the transit routing number
Digit (Record 6 , Field 4)
3. The first 34 digits of
3. For IAT, Sixth Addenda
<MemberIdentification> map to the
Record, Receiving DFI
Receiving DFI Identification
Identification (Record 7 ,
Field 5)
Name of the Receiving For IAT, Fifth IAT Addenda
Name
6.1.7 +++++ Depository Financial [0..1] Max140Text O Record, Receiving DFI
<Nm>
Institution Name (Record 7, Field 3)
48 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Identification of a
Department Max70Text
6.1.10 ++++++ division of a large [0..1] O
<Dept>
organisation or building
Identification of a sub-
Sub Department Max70Text
6.1.11 ++++++ division of a large [0..1] O
<SubDept>
organisation or building
Street Name Name of a street or Max70Text
6.1.12 ++++++ [0..1] O
<StrtNm> thoroughfare
Number that identifies
Building Number the position of a building Max16Text
6.1.13 ++++++ [0..1] O
<BldgNb> on a
street
Identifier consisting of a
Post Code group of letters and/or Max16Text
6.1.14 ++++++ [0..1] O
<PstCd> numbers that is added
to a postal address to
assist the sorting of mail
Name of a built-up area,
Town Name Max35Text
6.1.15 ++++++ with defined boundaries, [0..1] O
<TwnNm>
and a local government
Identifies a subdivision of
Country Sub Division Max35Text
6.1.16 ++++++ a country e.g., state, [0..1] O
<CtrySubDvsn>
region, country
49 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
International Bank
For IAT, IAT Addenda For
Account Number (IBAN)
Foreign Correspondent
- identifier used If <Cd> is present, set Foreign
1.1.1 IBAN Bank Information, Foreign
+++++ internationally by [1..1] Identifier M Correspondent Bank Identification
{OR <IBAN> Correspondent Bank
financial institutions to Number Qualifier to “03”
Identification Number
uniquely identify the
Qualifier (Record 7, Field 4)
account of a customer
Unique identification of
an account, as assigned Usage Rule: If <IBAN> is populated,
1.1.2 Other
+++++ by the account servicer, [1..1] M <Othr> should not be populated
OR} <Othr>
using an identification
scheme
50 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
51 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
52 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Unique and
unambiguous
identification of the
Identification account between the
1.1.0 ++++ [1..1] M
<Id> account owner and the
account servicer
Empty tag
International Bank The receiver's bank account number. If the
Account Number (IBAN) account number is less than 35 characters,
For IAT, Entry Detail Record,
- identifier used left justify, blank fill. (Alternate, could be
1.1.1 IBAN IBANIdentifier Foreign Receiver's Account
+++++ internationally by [1..1] M <Other><Identification>)
{OR <IBAN> Number/DFI Account
financial institutions to
Number (Record 6, Field 8)
uniquely identify the Usage Rule: If <Othr> is populated,
account of a customer <IBAN > should not be populated
Unique identification of
an account, as assigned
1.1.2 Other by the account servicer,
+++++ using an identification [1..1] M
OR} <Othr>
scheme
Empty tag
53 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
1.1.10 Proprietary Specifies the Type as a Usage Rule: If <Cd> is populated, < Prtry>
+++++ [1..1] Max35Text M
OR} <Prtry> proprietary code should not be populated
Empty tag
54 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Remittance Information Usage Rule: Optional field, either instance of ‘Structured’ or instance of ‘Unstructured’ should be used
Information that enables
the matching, i.e.,
reconciliation, of a 1. For CCD and PPD, Entry
payment with the items Detail Record, Addenda
that the payment is Record Indicator (Record
If present, set Addenda Record Indicator to
Remittance intended to settle, e.g., 6, Field 10)
2.98 +++ [0..1] O “1” (Look for <Structured> or
Information <RmtInf> commercial invoices in 2. For CTX and IAT, Entry
<Unstructured>)
an account receivable Detail Record, Addenda
system Record Indicator (Record
6, Field 12)
Empty tag
55 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Reference information to
allow the identification
Referred Document
of the underlying [0..n]
2.101 Information +++++ O
reference documents
<RfrdDocInf>
Empty tag
For CTX, Addenda Record,
Provides the type of the [0..1] Payment Related
2.102 Type <Tp> ++++++ O
referred document Information (Record 7,
Field 3)
Provides the type details
Code or Proprietary [1..1]
2.103 +++++++ of the referred M
<CdOrPrtry>
document
For CTX, Addenda Record, Presence implies equivalent to STP 820
Code +++++++ Document type in a [1..1] Code Payment Related RMR01 Segment (Reference Identification
2.104 M
<Cd> + coded form Information (Record 7, Qualifier)
Field 3)
Proprietary
Proprietary identification
+++++++ [1..1] Max35Text Usage Rule: If <Cd> is populated, <Prtry>
2.105 of the type of the M
<Prtry> + should not be populated
remittance document
Issuer
Identification of the
[0..1] Max35Text
2.106 +++++++ issuer of the reference O
<Issr>
document type
56 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Due Payable For CTX, Addenda Record,
Amount specified is the
Amount [0..1] Payment Related Equivalent to STP 820 RMR05 Segment
2.110 ++++++ exact amount due and Amount O
<DuePyblAmt Ccy> Information (Record 7, (Monetary Amount – Invoice Amount)
payable to the creditor
Field 3)
Amount of money
Discount Applied
resulting from the For CTX, Addenda Record,
Amount
application of an [0..1] Payment Related Equivalent to STP 820 RMR06 Segment
2.111 <DscntApldAmt ++++++ Amount O
agreed discount to the Information (Record 7, (Monetary Amount – Adjustment Amount)
Ccy>
amount due and Field 3)
payable to the creditor
Credit Note Amount Amount specified for the
[0..1]
2.112 <CdtNoteAmt Ccy> ++++++ referred document is the Amount O
amount of a credit not
Tax Amount Quantity of cash
2.113 [0..1]
<TaxAmt Ccy > ++++++ resulting from the Amount O
calculation of the tax
57 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
For CTX, Addenda Record,
Amount Amount of money of the
[1..1] Payment Related Equivalent to STP 820 ADX01 Segment
2.115 <Amt Ccy > +++++++ document adjustment Amount M
Information (Record 7, (Monetary Amount – Adjustment Amount)
Field 3)
Specifies whether the For CTX, Addenda Record,
Credit Debit
adjustment must be [0..1] Payment Related Include as part of ADX01 Segment to
2.116 Indicator +++++++ Code O
substracted or added to Information (Record 7, indicate a debit or credit adjustment
<CdtDbtInd>
the total amount Field 3)
For CTX, Addenda Record,
Reason Specifies the reason for {0..1] Max4Text Payment Related Equivalent to STP 820 ADX02 Segment
2.117 +++++++ O
<Rsn> the adjustment Information (Record 7, (Adjustment Reason Code)
Field 3)
For CTX, Addenda Record,
Additional Provides further details Equivalent to STP 820 ADX03 and ADX04
[0..1] Max140Text Payment Related
2.118 Information +++++++ on the document O Segments (Reference Identification
Information (Record 7,
<AddtlInf> adjustment Qualifier and Reference Identification )
Field 3)
For CTX, Addenda Record,
Amount of money
Remitted Amount [0..1] Payment Related Equivalent to STP 820 RMR04 Segment
2.119 ++++++ remitted for the referred Amount O
<RmtdAmt Ccy > Information (Record 7, (Monetary Amount – Amount Paid)
document
Field 3)
Reference information
provided by the creditor
Creditor Reference to allow the
[0..1]
2.120 Information +++++ identification of the O
<CdtrRefInf> underlying documents
Empty tag
58 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
59 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
Unique an unambiguous
Organisation
way of identifying an
9.1.13 Identification [1..1]
+++++++ organization M
{OR <OrgId>
Empty tag
Code allocated to
organisations by the ISO
9362 Registration
Authority, under an
international
BIC Or BEI +++++++ identification scheme, as
[0..1] Identifier Usage Rule: If <Othr> is populated,
9.1.1.4 <BICOrBEI> + described in the latest O
<BICOrBEI> should not be populated
version of the standard
ISO 9362 Banking
(Banking tele-
communication
messages, Bank Identifier
Codes)
60 | P a g e
Credit Transfer Transaction Information Definition: Set of elements used to provide information on the individual transaction(s) included in the message
Empty tag
For CTX, Addenda Record,
Identification +++++++ Identification assigned Equivalent to STP 820 Segment N104
[1..1] Max35Text Payment Related
9.1.16 <Id> ++ by an institution M (Identification Code e.g., Customer
Information (Record 7,
Account Number)
Field 3)
Name of the
+++++++
Scheme Name identification scheme [0..1]
9.1.17 ++ O
<SchmeNm>
Empty tag
Name of the
For CTX, Addenda Record,
Code +++++++ identification scheme, in
9.1.18 [1..1] Code Payment Related Equivalent to STP 820 Segment N103 (Payer
<Cd> +++ a coded form as O
{OR Information (Record 7, Identification Code Qualifier)
published in an external
Field 3)
list
+++++++ Name of the
9.1.19 Proprietary [1..1] Usage Rule: If <Cd> is populated, <Prtry>
+++ identification scheme, in Max35Text M
OR} <Prtry> should not be populated
a free text form
Unique and
Private Identification
9.1.21 unambiguous [1..1] Usage Rule: If <OrgId> is populated,
<PrvtId> +++++++ M
OR} identification of a party <PrvtId > should not be populated
Additional information, in
Additional For CTX, Addenda Record,
free text form, to
Remittance [0..3] Max140Text Payment Related Equivalent to STP 820 Segment REF03
2.129 +++++ complement the O
Information Information (Record 7, (Description)
structured remittance
<AddtlRmtInf> Field 3)
information
61 | P a g e
3. NACHA File Mapping Details
The tables that follow summarize the NACHA file format mappings of relevant PAIN.001 fields.
NACHA File Format Length Position M,R,O Content Description ISO 20022 Mapping Comments
62 | P a g e
9 Blocking Factor 2 38-39 M Number of records per block Not mapped, set to “10” by ODFI system
10 Format Code 1 40-40 M Must contain “1” Not mapped, set to "1" by ODFI system
Immediate Destination Identifies the bank processing the Maps to <PaymentInformation><DebtorAgent>
11 23 41-63 O
Name transaction e.g., BEST BANK <FinancialInstitutionIdentification><Name>
Company's name, up to 23 characters
12 Immediate Origin Name 23 64-86 O Maps to <GroupHeader><InitiatingParty><Name>
including spaces
May be blanks or space used for internal
13 Reference Code 8 87-94 O Not mapped*2
accounting purposes
NOTE:
*Field typically not used by U.S. banks
2Usage may vary with field populated based on bank specific criteria
63 | P a g e
b. Company/Batch Header Record – All SECs Except IAT
A batch is a collection of like entries within the file. A separate batch must be used if any of the batch-level
information, such as effective date or company name or company description changes.
NACHA File Format Length Position M,R,O Content Description ISO 20022 Mapping Comments
5 Company Identification 10 41-50 M 10-digit ID assigned by the bank Note <SchemeName><Code> also set. Examples:
“TXID” for Tax Identification Number
“CUST” Customer Identification Number
or other Code from External Code List
May map to3 <PaymentInformation> level or
<CreditTransferTransactionInformation> level…
<PaymentTypeInformation><LocalInstrument><Code>
64 | P a g e
Note preferable to avoid <Proprietary> and use applicable
<Code> from External Code List if possible
Description chosen by the originator to
8 Company Descriptive Date 6 64-69 O Not mapped*
identify the date for the receiver
The date on which the originator intends
9 Effective Entry Date 6 70-75 R Maps to <PaymentInformation><RequestedExecutionDate>
to post to the receiver's account
Inserted
The ACH Operator populates the actual
10 Settlement Date 3 76-78 by ACH Insert 3 blanks2
settlement date
Operator
Identifies the Originator as a non-Federal Not mapped, set to "1" for non-Federal Government entity
11 Originator Status Code 1 79-79 M
Government entity based on client on-boarding process
Maps to first 8 digits of ABA Number
Originating DFI ABA or transit routing <PaymentInformation><DebtorAgent>
12 Originating DFI Identification 8 80-87 M
number assigned <FinancialInstitutionIdentification>
<ClearingSystemMemberIdentification><MemberIdentification>
Maps to
<PaymentInformation><PaymentInformationIdentification>
Originator assigns batch numbers in
13 Batch Number 7 88-94 M
ascending order within each file
Else, set by ODFI system2
NOTE:
*Field typically not used by U.S. banks
2Usage may vary with field populated based on bank specific criteria
3 Can be set at the Payment Information level or the Credit Transfer Transaction level. It is possible to have multiple Payment Information blocks, but they must share the
same batch information e.g., Debtor (Company), Debtor Account (Company bank account), Debtor Agent (Company bank), as well as the Requested Execution
Date. However Payment Type Information (e.g., SEC Code, Company Entry Description) cannot be used in both levels.
65 | P a g e
c. Company/Batch Header Record – IAT Only (Outbound Payments)
The Company/Batch Header Record identifies the Originator and briefly describes the purpose of the entry. Note that
the mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
66 | P a g e
Other values for <Rate Type>:
"SALE" = market rate at the time of the sale
"SPOT” = spot rate
67 | P a g e
Maps to first 8 digits of ABA Number
<PaymentInformation><DebtorAgent>
<FinancialInstitutionIdentification>
Originating DFI ABA or transit routing
16 Originating DFI Identification 8 80-87 M <ClearingSystemMemberIdentification><MemberIdentification>
number assigned
Note <ClearingSystemMemberIdentifciation><Code> also set to
"USABA"
Maps to
Originator assigns batch numbers in <PaymentInformation><PaymentInformationIdentification>
17 Batch Number 7 88-94 M
ascending order within each file
Else, set by ODFI system2
NOTE:
2Usage may vary with field populated based on bank specific criteria
3 Can be set at the Payment Information level or the Credit Transfer Transaction level. It is possible to have multiple Payment Information blocks, but they must share the
same batch information e.g., Debtor (Company), Debtor Account (Company bank account), Debtor Agent (Company bank), as well as the Requested Execution
Date. However Payment Type Information (e.g., SEC Code, Company Entry Description) cannot be used in both levels.
68 | P a g e
d. CCD or PPD Entry Detail Record
The CCD Entry Detail Records contain information about the Receiver and the Receiver's financial institution.
CCD Length Position M,R,O Content Description ISO 20022 Mapping Comments
69 | P a g e
[NOTE: As content varies by client and on-boarding process2
requirements for mapping may differ as well.]
”0” = no addenda record supplied
10 Addenda Record Indicator 1 79-79 M Set Addenda Record Indicator to “1” if element
”1” = one addenda record supplied
<RemittanceInformation><Unstructured> or <Structured>
present
70 | P a g e
e. CTX Entry Detail Record
The CTX Entry Detail Records contain information about the Receiver and the Receiver's financial institution.
CTX Length Position M,R,O Content Description ISO 20022 Mapping Comments
71 | P a g e
10 Reserved 2 75-76 N/A Leave blank Not mapped*
Field defined by the ODFI some banks
11 Discretionary Data 2 77-78 O Not mapped*2
request it be left blank
[NOTE: As content varies by client and on-boarding process2
requirements for mapping may differ as well.]
“0” = no addenda record supplied
12 Addenda Record Indicator 1 79-79 M ”1” = one or more addenda records
Set Addenda Record Indicator to “1” if element
supplied
<RemittanceInformation><Unstructured> or <Structured>
present
Means for the originator to identify the
individual entries. Field is constructed as
follows: the first 8 digits are the ODFI transit
Not mapped, generated by ODFI system: set first 8 digits to ODFI
13 Trace Number 15 80-94 M routing number or Field 12 of the
transit routing number followed by sequential number
Company/Batch Header. The remainder
positions must be a unique number in
sequential order
NOTE:
*Field typically not used by U.S. banks
2Usage may vary with field populated based on bank specific criteria
72 | P a g e
f. IAT Entry Detail Record (Outbound Payments)
The IAT Entry Detail Records contain information about the Receiver and the Receiver's financial institution. IAT is a bi-
directional transaction. Note that the mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S.
to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
73 | P a g e
Else <CreditTransferTransactionInformation><CreditorAccount>
<Identification> <Other><Identification>
74 | P a g e
g. CCD Addenda Record (Optional)
CCD entries will accommodate the transmission of optional remittance information.
CCD Length Position M,R,O Content Description ISO 20022 Mapping Comments
CCD Addenda Record (7) NOTE: A maximum of 1 optional addenda record may be included with each CCD entry
75 | P a g e
h. CTX Addenda Record (Optional)
CTX entries will accommodate the transmission of optional remittance information.
CTX Length Position M,R,O Content Description ISO 20022 Mapping Comments
CTX Addenda Record (7) NOTE: A maximum of 9,999 optional addenda records may be included with each CTX entry
76 | P a g e
i. IAT First Addenda Record (710) (Outbound Payments)
The First IAT Addenda Record identifies the Receiver of the transaction and the dollar amount of the payment. Note that
the mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
First IAT Addenda Record (7) NOTE: The first seven IAT addenda records are mandatory for each IAT entry
77 | P a g e
trace number (Field 13) of the related
Entry Detail Record
NOTE:
*Field typically not used by U.S. banks
4For 3rd party payment i.e., payment on behalf of, maps to <UltimateDebtor> fields
78 | P a g e
j. IAT Second Addenda Record (711) (Outbound Payments)
The Second and Third IAT Addenda Records identify key information related to the Originator of the entry. Note that the
mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
79 | P a g e
k. IAT Third Addenda Record (712) (Outbound Payments)
Note that the mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
80 | P a g e
l. IAT Fourth Addenda Record (713) (Outbound Payments)
The Fourth IAT Addenda Record contains information related to the financial institution originating the entry. Note that the
mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
81 | P a g e
m. IAT Fifth Addenda Record (714) (Outbound Payments)
The Fifth IAT Addenda Record identifies the Receiving financial institution holding the Receiver's account. Note that the
mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
82 | P a g e
n. IAT Sixth Addenda Record (715) (Outbound Payments)
The Sixth and Seventh IAT Addenda Records identify key information related to the Receiver of the entry. Note that the
mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
83 | P a g e
o. IAT Seventh Addenda Record (716) (Outbound Payments)
Note that the mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
84 | P a g e
p. IAT Addenda Record for Remittance Information (717) (Optional) (Outbound Payments)
IAT entries will accommodate the transmission of optional remittance information. Note that the mapping provided herein
is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
IAT Addenda For Remittance Information Record (7) NOTE: A maximum of two optional remittance addenda records may be included with each IAT entry
85 | P a g e
q. IAT Addenda Record for Foreign Correspondent Bank Information (718) (Outbound Payments)
IAT Addenda Records for Foreign Correspondent Bank Information applies to Incoming/Received IAT entries only. Note
that the mapping provided herein is for outbound IAT only i.e., funds are moving from the U.S. to a foreign country.
IAT Length Position M,R,O Content Description ISO 20022 Mapping Comments
IAT Addenda For Foreign Correspondent Bank Information Record (7) NOTE: A maximum of three optional Foreign Correspondent Bank addenda records may be included with
each IAT entry
1 Record Type Code 1 01-01 M Code identifying the Addenda Record Not mapped, set by ODFI system to "7"
type is "7"
2 Addenda Type Code 2 02-03 M Code identifying the Addenda Record for Not mapped, set by ODFI system to "18"
Foreign Correspondent Bank Information
for IAT
3 Foreign Correspondent Bank 35 04-38 M This field identifies the name of the Foreign Maps to IntermediaryAgent2><FinancialInstitutionIdentification>
Name Correspondent Bank <Name> or <IntermediaryAgent3>
<FinancialInstitutionIdentification><Name>
4 Foreign Correspondent Bank 2 39-40 M This field contains a 2-digit code that Set to:
Identification Number identifies the numbering scheme used in “01” if
Qualifier the Foreign Correspondent Bank <CreditTransferTransactionInformation><IntermediaryAgent2> or
Identification Number field. Code values <IntermediaryAgent3><FinancialInstitutionIdentification>
for this field are: <ClearingSystemMemberIdentification>
“01” = National Clearing System Number <ClearingSystemIdentification><Code> is present
(e.g., U.S. Routing Transit Number) “02” if
“02” = BIC Code <CreditTransferTransactionInformation><IntermediaryAgent2> or
“03” = IBAN <IntermediaryAgent3> <FinancialInstitutionIdentification><BIC> is
present
“03” if <CreditTransferTransactionInformation>
IntermediaryAgent2Account> or
<IntermediaryAgent3Account><Identification><IBAN> is present
5 Foreign Correspondent Bank 34 41-74 M This field contains bank identification Maps to:
Identification Number number (i.e., the National Clearing System <CreditTransferTransactionInformation><IntermediaryAgent2> or
Number, BIC Code, or IBAN) of the Foreign <IntermediaryAgent3><FinancialInstitutionIdentification>
Correspondent Bank <ClearingSystemMemberIdentification> <MemberIdentification>
Else
<CreditTransferTransactionInformation><IntermediaryAgent2> or
<IntermediaryAgent3> <FinancialInstitutionIdentification><BIC>
Else <CreditTransferTransactionInformation>
<IntermediaryAgent2Account> or
<IntermediaryAgent3Account><Identification><IBAN>
6 Foreign Correspondent Bank 3 75-77 M This field contains a 2-character code as
Branch Country Code approved by the International Maps to
Organization for Standardization (ISO) <CreditTransferTransactionInformation><IntermediaryAgent2> or
used to identify the country in which the <IntermediaryAgent3><FinancialInstitutionIdentification><Postal
branch of the Foreign Correspondent Address><Country>
Bank is located
7 Reserved 6 78-83 N/A Leave blank Not mapped*, leave blank
86 | P a g e
8 Addenda Sequence 4 84-87 M Sequence number of each type of "18" Not mapped, system generated, set in ascending order
Number Foreign Correspondent Bank Identification beginning with 0001
addenda in ascending order beginning
with 0001
9 Entry Detail Sequence 7 88-94 M This field contains the ascending
Number sequence number section of the Entry
Detail or Corporate Entry Detail Record‘s Not mapped, system generated from last 7 digits of Trace
trace number. This number is the same as Number
the last seven digits of the trace number
(Field 13) of the related Entry Detail
Record
NOTE:
*Field typically not used by U.S. banks
87 | P a g e
r. Batch/Control Record – All Formats
The Company/Batch Control Record summarizes the information contained within the batch. It contains the counts, hash
totals, and total dollar controls for the entries within the batch.
NACHA File Format Length Position M,R,O Content Description ISO 20022 Mapping Comments
7 Company Identification 10 45-54 R 10-digit ID assigned by the bank Note <SchemeName><Code> also set. Examples:
“TXID” for Tax Identification Number
“CUST” Customer Identification Number
or other Code from External Code List
Message Authentication
8 19 55-73 O Leave blank Not mapped*
Code
9 Reserved 6 74-79 N/A Leave blank Not mapped*2
Maps to first 8 digits of ABA Number
<PaymentInformation><DebtorAgent>
Originating DFI Originating DFI ABA or transit routing
10 8 80-87 M <FinancialInstitutionIdentification>
Identification number assigned
<ClearingSystemMemberIdentification>
<MemberIdentification>
Maps to
Sequential number assigned by the
<PaymentInformation><PaymentInformationIdentification>
11 Batch Number 7 88-94 M originator. Must be equal to Field 13 of the
Company/Batch Header Record
Else, set by ODFI system2
88 | P a g e
NOTE:
*Field typically not used by U.S. banks
2Usage may vary with field populated based on bank specific criteria
89 | P a g e
s. File Control Record – All Formats
The File Control Record summarizes the information carried in the Company/Batch Control Records. It contains dollar,
entry, and hash total accumulations from the Company/Batch Control Records in the file. This record also contains counts
of the number of blocks and the number of batches within the file.
NACHA File Format Length Position M,R,O Content Description ISO 20022 Mapping Comments
90 | P a g e
4. Remittance Information
The content of remittance data varies by the bank client and the on-boarding process. For the CCD Standard Entry Class
Code, the NACHA Operating Rules permit the exchange of endorsed banking conventions or ANSI ASC X12 syntax-based
data segments within the addenda record. In a CTX payment, the NACHA Operating Rules permit the exchange of ANSI ASC
X12 transaction set containing a BPR or BPS data segment, or payment related UN/EDIFACT syntax.
It should be noted that this Guide offers documentation for the future support of CCD ISO 20022-based XML remittance
addenda. Given that state agencies today do not accept XML data, NACHA does not support the transmission of XML
messages for CCD+ at this time. However, this information has been included below in preparation for when markets evolve.
a. CCD Addenda – NACHA Endorsed Banking Conventions for TXP, DED, and TPP Payments
Corporate Credit or Debit Entry (CCD) payments have a limitation of only one 80-character remittance addendum. In
order to transmit remittance information with CCD transactions in XML formatted data, either an unstructured and
structured format may be used. Note that the structured XML tags can utilize most of, if not more than, the 80-characters in
the one addendum. In both scenarios, with structured or unstructured XML formatted data, payments reconciliation and
straight-through processing can still be achieved by following the guidelines provided.
Today, the NACHA Operating Rules allow endorsed banking conventions for “TXP”, “DED”, and “TPP” to accompany a
CCD payment utilizing ANSI ASC X12 standards. The banking conventions define the data and formats for these specific
use cases mostly for government payments:
91 | P a g e
1) Unstructured
In an unstructured form, it is recommended that remittance information transmitted is consistent with the current
practice of NACHA banking conventions that is exchanged today in EDI X12 ANSI format. Of note, the use of all
mandatory and optional fields in the TPP and DED conventions inclusive of the “*” field separators can exceed the 80
character limit in EDI format and within an unstructured XML format. Therefore, it is the responsibility of each user to
ensure the 80-character limit is not exceeded.
The following provide examples of NACHA banking convention remittance addendum in an unstructured XML format:
<RmtInf>
<Ustrd>TXP*3710123456*011*061231*t*10199997*P*200000\</Ustrd>
</RmtInf>
<RmtInf>
<Ustrd>DED*CS*1998-840123-DM*20070613*46252*386863555*Y*Doe,John*26082*N\</Ustrd>
</RmtInf>
<RmtInf>
<Ustrd>TPP*208*123456789*20121130*100000*1122*SMITH JOHN*AB123456\</Ustrd>
</RmtInf>
92 | P a g e
As XML formatted data is not accepted market practice, in order to transmit the addenda information to the clearing
system, it is recommended that the ODFI drops the unstructured tags and include the remittance information in the “7”
record of the NACHA file to pass on the data. An illustration is provided below.
Figure 10:
1 2 3 4 5 6 7 8
12345678901234567890123456789012345678901234567890123456789012345678901234567890
Example Data
2) Structured
If the NACHA endorsed banking conventions for DED, TXP, and TPP are transmitted in a structured form in the payment
instruction file to the ODFI, following the guidelines provided below is recommended. Note that the structured data
elements may not all fall within the Remittance Information section in the pain.001 message.
Further, as previously noted, XML formatted data is not accepted market practice for CCD+. In order to transmit the
structured addenda information to the clearing system, it is recommended that the XML tags are dropped, the data
concatenated to follow the current practice of EDI X12 ANSI format exchanged today, and to include the remittance
information in the “7” record of the NACHA file.
Tax payments made by businesses to state revenue authorities are supported through the use of the TXP segment in
ACH addenda. The ISO equivalent and mappings for TXP01–TXP10 are provided below for the pain.001 message.
Note that some segments (TXP05, TXP07, and TXP09 as well as TXP04, TXP06, and TXP08) can have multiple occurrences
and may be mapped to the same data element.
93 | P a g e
Table 1: NACHA Endorsed Banking Convention – TXP Mapping to ISO Equivalent*
<CreditTransferTransactionInformation><Tax><Record>
Amount of tax liability owed and/or <TaxAmount><TotalAmountCurrency>
paid. If no subsequent amounts are
reported in data elements TXP07 and Optional to also include here when no other tax amount(s), i.e.,
TXP05 Tax Amount TXP09, the amount value reported in TXP07 and/or TXP09 is present:
TXP05 must equal the value <CreditTransferTransactionInformation><Tax>
contained in Field 6 in the CCD Entry <TotalTaxAmount>
Detail Record [Total of all <Record> level Tax Amounts. Total of the actual tax
payment.]
94 | P a g e
Amount of tax liability owed and/or
paid. This amount value is optional,
but must be used if TXP06 is present. If
no subsequent amount is
<CreditTransferTransactionInformation><Tax><Record>
TXP07 Tax Amount reported in data element TXP09, the
<TaxAmount><TotalAmountCurrency>
total amount value reported in the
convention (TXP05 +TXP07) must
equal the value contained in Field 6
in the CCD Entry Detail Record
Identifies the type of amount that
immediately follows:
T= Tax
Amount Type (Tax <CreditTransferTransactionInformation><Tax><Record>
TXP08 I= Interest
Information ID Number) <CategoryDetails>
S= State
L= Local
C = City
Amount of tax liability owed and/or
paid. This amount value is optional,
but must be used if TXP08 is present.
The total amount value reported in <CreditTransferTransactionInformation><Tax><Record>
TXP09 Tax Amount
the convention (TXP05 <TaxAmount><TotalAmountCurrency>
+TXP07+TXP09) must equal the value
contained in Field 6 in the CCD Entry
Detail Record
Optional data element that may be
<CreditTransferTransactionInformation><Tax><Debtor>
TXP10 Taxpayer Verification used by the receiver to verify the
<TaxIdentification>
taxpayer's identify
*Please refer to ISO 20022 pain.001 file for the paths provided above.
Tax payments made by third parties, such as employers to government agencies for delinquent taxpayers are
supported through the use of the TPP segment in the ACH addenda. The ISO equivalent and mappings for TPP01–
TPP07 are provided below for the pain.001 message. Note that TPP03 and TPP07 may be mapped to multiple ISO
equivalent data elements. It is also important to be aware that all data elements do not fall within the Remittance
Information section of the ISO message.
95 | P a g e
Table 2: NACHA Endorsed Banking Convention – TPP Mapping to ISO Equivalent*
96 | P a g e
Garnishment – DED Segment
Garnishments made by third parties, such as employers to government agencies for child support are supported
through the use of the DED segment in the ACH addenda. The ISO equivalent and mappings for DED01–DED09 are
provided below for the pain.001 message. Note that not all data elements fall within the Remittance Information
section of the ISO message.
97 | P a g e
agency that an individual’s employment
has terminated
*Please refer to ISO 20022 pain.001 file for the paths provided above.
b. CTX Addenda
The Corporate Trade Exchange (CTX) format supports the transfer of funds within a trading partner relationship utilizing a
full ANSI ASC X12 message, or when payment-related UN/EDIFACT information is sent with the funds transfer. CTX can
accommodate the transmission of a maximum of 9,999 addenda records each carrying 80 characters of payment related
data (to pay multiple invoices) in the “7” record of the NACHA file. A common type of remittance application is the limited
ANSI X12 STP 820 and DED (Child Support Garnishment).
Note that NACHA does not offer mapping of ISO 20022 messages to the full ANSI X12 820 transaction set. Corporations and
financial institutions should work together to identify existing EDI data requirements and compliance with trading partner
needs.
98 | P a g e
1) Structured Data – STP 820 (EDI)
The STP 820 is a limited remittance advice grouped by the following:
STP 820 specifies up to 10 required data elements, with two elements -- customer name and customer account
number (N1 segments) – that are part of the payment information as mandatory. When invoices are being paid, there
are eight additional fields such as invoice number, gross invoice amount, and amount paid to be included with the
electronic payment for each invoice being paid. The ISO equivalent found in the
<RemittanceInformation><Structured> section is provided in the table that follows.
STP 820
Data Element ISO 20022 Equivalent
Segment
Remittance Information or RMR
RMR01 Reference Identification Qualifier [IV, PO, R7] <ReferredDocumentInformation><Type><CodeOrProprietary><Code>
Reference Identification (e.g., Invoice
RMR02 <ReferredDocumentInformation><Number>
Number]
RMR03 Payment Action Code (not typically used) Set to *
RMR04 Monetary Amount [Amount Paid] <ReferredDocumentAmount><RemittedAmount>
RMR05 Monetary Amount [Invoice Amount] <ReferredDocumentAmount><DuePayableAmount>
RMR06 Monetary Amount [Adjustment Amount] <ReferredDocumentAmount><DiscountAppliedAmount>
Reference Information or REF
Reference Identification Qualifier [BM, PO,
REF01 <CreditorReferenceInformation><Type><CodeOrProprietary><Code>
R7, VV]
Reference Identification (e.g., PO Number,
REF02 <CreditorReferenceInformation><Reference>
Voucher Number)
REF03 Description <AdditionalRemittanceInformation>
99 | P a g e
Date / Time Information or DTM
DTM01 Date / Time Qualifier [003, 004, 092] Map qualifier based on RMR01
DTM02 Date <ReferredDocumentInformation><RelatedDate>
Adjustment Information or ADX
ADX01 Monetary Amount [Adjustment Amount] <ReferredDocumentAmount><AdjustmentAmountAndReason><Amount>
ADX02 Adjustment Reason Code <ReferredDocumentAmount><AdjustmentAmountAndReason><Reason>
Reference Identifier Qualifier (Code
ADX03
qualifying reason for change) <ReferredDocumentAmount><AdjustmentAmountAndReason>
Reference Identification (Additional <AdditionalInformation>
ADX04
descriptive information)
Originator and Receiver Name Identification or N1
N1 – Originator Name Identification or “Payer”
N101 Entity Identifier Code (PR = Payer) <Invoicee> implies entity identifier “PR”
N102 Payer Name {Mandatory field} <Invoicee><Name>
Payer Identification Code Qualifier (Code
designating the system/method of code <Invoicee><Identification><OrganisationIdentification><Other><SchemeName>
N103
structure used for Identification Code e.g., 1= <Code>
DUNS, 24 = Employer ID )
Identification Code (Payer Tax ID or
N104 Customer Account Number) {Mandatory <Invoicee><Identification><OrganisationIdentification><Other><Identification>
field}
N1 – Receiver Name Identification or “Payee”
N101 Entity Identifier Code (PE = Payee) <Invoicer> implies entity identifier “PE”
N102 Payee Name <Invoicer><Name>
Additionally, payment related data other than those noted above may also be transmitted within the structured
remittance information. These include such information as tax amount, address, etc.
100 | P a g e
2) Comparison of ISO 20022 XML Syntax with STP 820
Provided below is a comparison between STP 820 data elements and ISO 20022 equivalent XML information.
Reference Information STP 820 (EDI) Structure ISO 20022 XML Structure
101 | P a g e
9 Adjustment Amount (ADX01) ADX*-8.98*01\ <AdjstmntAmtAndRsn>
<Amt Ccy="USD">8.98</Amt>
<CdtDbtInd>DBIT</CdtDbtInd>
<Rsn>01</Rsn>
</AdjstmntAmtAndRsn>
10 Adjustment Reason Code (ADX02) ADX*-8.98*01\ <Rsn>01</Rsn>
Figure 11:
<Strd>
<RfrdDocInf>
<Tp>
<CdOrPrtry>
<Cd>CINV</CD>
</CdOrPrtry>
</Tp>
<Nb>A123456</Nb>
<RltdDt>2011-10-01</RltdDt>
</RfrdDocInf>
<RfrdDocAmt>
<DuePyblAmt Ccy=“USD”>100.00</DuePyblAmt>
<DscntApldAmt Ccy= “USD”>2.00</DscntApldAmt>
<TaxAmt Ccy=“USD”>0.00</TaxAmt>
<RmtdAmt Ccy=“USD”>98.00</RmtdAmt>
</RfrdDocAmt>
<CrtrRefInf>
<Ref>56789546</Ref>
</CrtrRefInf>
<AddtlRmtInf>DISCOUNT ALLOWED PER JANE DOE CALL NOV 1</AddtlRmtInf>
</Strd>
102 | P a g e
3) DED
Many states allow employers to remit child support payments electronically using the NACHA CTX format containing
ASC X12 820 Payment Order/Remittance Advice Transaction Set or the NACHA CCD format. Use of the CTX/820
enables an employer to send multiple child support payments with remittance information in one transaction set with a
maximum allowance of 9,999 Addenda Records to a State Disbursement Unit. For guidance and examples of ISO
20022 Mapping to DED Child Support Segment, please refer to the earlier CCD Addenda Section.
Note that while this Guide offers documentation for the future support of ISO 20022-based XML remittance addenda
for DED Segment, given that state agencies today do not accept XML data, NACHA does not support the transmission
of XML messages for this segment at this time. However, this information has been included in preparation for when
markets evolve.
c. IAT Addenda
The IAT addenda records are taken up by data elements defined by the Bank Secrecy Act’s “Travel Rule” information (i.e.,
Originator name, address, account number; Originator's depository institution name and payment amount; Receiver
name, address, account number; and the Receiver's financial institution) to comply with OFAC-sanctioned guidance. In its
existing state, there is limited space to transmit payment related data. Any data elements relating to payment instructions
screened against sanctions lists will need to apply to remittance information as well. Given the originator and receiver must
be able to open up the payment “envelope” to examine the addenda records for “bad” guys, today’s practice is to
provide a reference source for additional information for re-association in an unstructured format (see below example), or
in a structured related remittance information specifying a separate location the remittance advice has been sent. For
transmission to the clearing system, it is recommended that the XML tags are dropped and to include the remittance
information in the “7” record of the NACHA file.
103 | P a g e
5. Same Day ACH
Originators can indicate the intent for a U.S. ACH payment to be sent “today” by including “today’s date” in the “Requested Entry
Date” field in the payment instruction pain.001 for same day processing. The Effective Entry Date in an ACH transaction is the required
indicator for Same Day ACH transactions.
The use of “Company Descriptive Date” field is an optional indicator for a Same Day ACH transaction, and its use is at the discretion of
the ODFI. Valid content may be either “SD1300” or “SD1700,” which denotes same day processing and the military designation
“HHMM” for the hour and minutes that correspond to the desired settlement timing of either 1:00 PM ET or 5:00 PM ET. As this field is
optional the ACH Operator will not validate this field.
NACHA File Format Length Position M,R,O Content Description ISO 20022 Mapping Comments
104 | P a g e
6. Exceptions – Returns and Rejects
In some cases, credit transactions from originating parties may be returned or rejected.
Unsuccessful execution before settlement results in a reject transaction. If it is after
settlement, the result is a return transaction. To better understand the flow of these
messages, please refer to the scenarios presented at the beginning of this document
(Section 2).
Rejects are transactions that may be diverted from normal execution by the ODFI or
Debtor Agent for reasons related to technical issues as invalid format, missing
information, etc. The reason information for a reject is included in the Customer Payment
Status Report or pain.002 message.
Returns are funds sent back by the Payee or Receiver to the Payer or Originator following
settlement of the original payment instruction. The reason for the return will usually be
reported to the Originator, along with the reference number of the original payment
instruction in a Cash Management or camt message to facilitate reconciliation. The
possible reasons for rejects and returns are translated into a standardized (ISO) reason
code available in the ISO External Code List:
http://www.iso20022.org/external_code_list.page.
NACHA guidance on returns and rejects are available separately on the ISO 20022
Resource Center: https://www.nacha.org/ISOresources.
105 | P a g e
7. Appendix
Mandatory Fields
End-to-End Identification
Message Identification
Payment Information Identification
Optional Fields
Instruction Identification
Creditor and Debtor Identification
Ultimate Debtor/Creditor Identification
Remittance Information
Proprietary Codes
1) Basic Latin
The Basic Latin Unicode block is the first block of the Unicode standard. The
block also incorporates ASCII (American Standard for Information
Interchange) accepted in NACHA file formats. The following are valid Basic
Latin characters:
Character Description
a-z 26 small characters of the Latin alphabet
A–Z 26 capital characters of the Latin alphabet
0-9 10 numeric characters
/ solidus (slash)
- hyphen
? question mark
; Colon
( open parenthesis
) close parenthesis
. full stop
106 | P a g e
Character Description
, comma
‘ apostrophe
+ plus
space
= equal to
! exclamation mark
“ quotation mark
% percent
& ampersand
* asterisk
< less than
> greater than
; semi-colon
@ at
# pound (hash)
$ dollar
{ open curly bracket
} close curly bracket
[ left square bracket
] right square bracket
\ back slash
_ underscore
^ circumflex
` grave accent
| vertical line
~ tilde
Control Codes Description (in common use)
CR carriage return
LF line feed
<Cdtr>
<Nm>AB & C TRANSPORT </Nm
</Cdtr>
d. Related Resources
1) ISO 20022
The XML format of the pain.001 file is based on an XML standard published by
the ISO organization. ISO 20022 defines the formats for files used in the
financial area. The ISO 20022 Message Definition report (MDR), Message
Guideline (MUG), and XML schema pain.001.001.03.xsd can be downloaded
from the ISO20022 web site at
https://www.iso20022.org/message_archive.page
108 | P a g e
topics on the use of ISO 20022 messages and other related activities, in the
payments domain.
109 | P a g e
8. Revision History
110 | P a g e