Documente Academic
Documente Profesional
Documente Cultură
Bank
CustomerCreditTransferInitiationV03
pain.001.001.03
Date Last Modified: July 16, 2019
Version 1.0
XML Declaration:
Specify standard XML version declaration and the <Document> tag with an appropriate namespace before. Example:
<?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">
This declaration is made before the Message Root tag at the start of the ISO message.
~ Any data populated in a schema-defined optional field that is not required will be ignored and will not stop processing
of the payment. This rule includes elements that are designated "Not Used" by the bank.
~ If field is used by the bank processing, one of the above usage statuses will be specified (O, R
or C). Otherwise, when the field is not used, no status is noted.
~ Where individual clients do not maintain Required or Conditional data elements in their systems, they should consult
with U.S. Bank on the minimum of data elements required for that type of transaction. This could result in the need to
add those data elements into the client's systems.
~ Clients should consult with their Beneficiary Banks on the regulatory requirement rules defined by the Central Bank in
those countries and provide that information in the required format.
~ Any of the data tags included in this guide will be accepted by U.S. Bank. The bank will either use the tag for
processing or ignore it.
INTRODUCTION
This document details the usage of ISO 20022 pain.001.001.03 (Customer Credit Transfer Initiation) by U.S. Bank and
provides guidance on how information is to be structured for exchange between customers and U.S. Bank. This
implementation complies with standard content and use, as set under ISO 20022 message definitions. While only
applicable information is detailed, full documentation can be found per links below. Message elements not represented in
this document but meeting standard will be ignored.
~ ISO 20022 Message Definition Report (MDR), Message Usage Guideline (MUG) and XML schema
(pain.001.001.02.xsd)
https://www.iso20022.org/message_archive.page#PaymentsInitiation3
~ Payments External Code List which provides the standard code values for payment message elements
https://www.iso20022.org/external_code_list.page
MESSAGE STRUCTURE
The main blocks of the Customer Credit Transfer Initiation message as defined by the schema are as follows:
1. Group Header <GrpHdr> (1..1). This block is mandatory and should be present only once in the file. It contains a set
of general elements that are common to the entire message such as message identification date and time, number of
transactions in the message, etc.).
2. Payment Information <PmtInf> (1..n). This block is mandatory and can repeat. It contains a set of elements related
to the creditor side of the message. It consists of payment identification, payment method, debtor details (name,
account number, bank), etc.
3. Transaction Information <CdtTrfTxInf> (1..n). This block is a part of the Payment Information block and is mandatory
and repetitive. It contains a set of elements related to the creditor side of the transaction. It indicates payment and
transaction identification, amount, creditor information, etc.
PERMITTED CHARACTERS
ISO 20022 XML messages should be encoded using UTF-8 as indicated on first line of file.
<?xml version="1.0" encoding="UTF-8"?>
The supported characters for this implementation:
Alpha (A - Z, a - z, and spaces)
Numeric (0 - 9)
Special Characters: See Appendix A tab
Reserved XML characters must be represented by entity references (ex. < = < or < in XML file)
VALIDATION OF MESSAGES
The incoming pain.001 message will be validated against the schema pain.001.001.03.xsd.
~ If the message fails schema validation, the entire message/file will be rejected.
~ If the message fails duplicate checking, the entire message/file will be rejected.
~ If the file header field(s) fail validation rule, the entire message/file will be rejected.
~ If the PaymentInformation group field(s) fail validation rule, all transactions in the batch will be rejected.
~ At the transaction level, single payments will be validated against any additional rules set forth
and only the transaction in error will be rejected.
~ A 1st Level CustomerPaymentStatusReport (pain.002.001.03) will be sent file once the file
passes or fails technical validation.
~ A 2nd Level CustomerPaymentStatusReport (pain.002.001.03) will be sent once the file
reaches the backend system.
MLSchema-instance">
ema
ements
as follows:
t of elements related
or details (name,
ML file)
ejected.
Level ISO Or Message Item 1 2 3 4 5 6 7 8 9 10 11 12 Full Path Type Min Max Min Max File Level Field Description Repetitive Semi-
Index Tag Len Leng Occur Occurs Rejection Wire (All Repetitive
No. Tree gth th s types) Wire (all
types)
4 1.2 CreationDateTime CreDtTm Document/CstmrCdtTrfIDateTime 1 1 Use ISO format (yyyy-mm-ddThh:mm:ss or yyyy-mm-ddThh:mm:ssZ or yyyy- R R
mm-ddThh:mm:ss+HH:MM)
4 1.6 NumberOfTransactions NbOfTxs Document/CstmrCdtTrfIText 1 1 Y Specify the total number of transactions in the entire message. Element will be R R
validated by the bank. If validation fails, the entire message will be rejected
and the reason will be reflected in your pain.002 Payment Status Report. This
value is used for duplicate checking.
4 1.7 ControlSum CtrlSum Document/CstmrCdtTrfIQuantity 0 1 Y While this field is optional, best practice is to provide this element. If populated, O O
this field will be validated and the entire message will be rejected if the value
doesn’t match calculated total amount. This value is used for duplicate
checking if provided.
3 2.0 PaymentInformation PmtInf Document/CstmrCdtTrfI 1 * PaymentInformation - Batch Level. Transactions must be grouped by
Company ID (CIF-ID), Payment Type, Debtor account and currency, execution
date.
4 2.1 PaymentInformationIdentification PmtInfId Document/CstmrCdtTrfIn
Text 1 35 1 1 Batch Reference Number. This number should be unique for each batch within R R
the file. The value is not validated except for the length.15 characters max
length is allowed.
4 2.2 PaymentMethod PmtMtd Document/CstmrCdtTrfICode 1 1 Payment Method. Always value "TRF" for ACH and WIRE. R R
For Check populate as "CHK" TRF TRF
4 2.4 NumberOfTransactions NbOfTxs Document/CstmrCdtTrfIText 0 1 Number of Total Transactions in this Message. This value is not validated if O O
provided.
4 2.5 ControlSum CtrlSum Document/CstmrCdtTrfIQuantity 0 1 Control Sum (Hash Total) of all Transactions in this Message. This value is not O O
validated if provided.
4 2.6 PaymentTypeInformation PmtTpInf Document/CstmrCdtTrfI 0 1
5 2.8 ServiceLevel SvcLvl Document/CstmrCdtTrfI 0 1
6 2.9 {Or Code Cd Document/CstmrCdtTrfICode 1 4 1 1 Service Code - Payment Information Level. It is required to specify Service R R
Level Code on the PmtInf level. All transactions in the same PmtTpInf batch URGP URGP
should be of the same payment type (ACH, WIRE or Check) in case multiple
payment types are sent in the same file.
4 2.17 RequestedExecutionDate ReqdExctnDt Document/CstmrCdtTrfIDateTime 1 1 Requested Execution Date of the Payment Instruction (e.g. Value Date) in R R
yyyy-mm-dd format. Must be populated on the Payment Information Level.
Domestic wires can be value dated out up to 30 calendar days. If a value date
lands on a no business day, the wire will be sent on the next business day.
International transactions must always be dated current day.
4 2.27 CreditTransferTransactionInformation CdtTrfTxInf Document/CstmrCdtTrfIn 1 * Transaction Level. This group repeats for each transaction in the batch.
7 Ccy Document/CstmrCdtTrfIAttribute 1 1 CCY in which the receiver of payment will receive the amount R R
5 2.47 ExchangeRateInformation XchgRateInf Document/CstmrCdtTrfIn 0 1
6 2.48 ExchangeRate XchgRate Document/CstmrCdtTrfIRate 0 1 Only send exchange rate if the deal number is populated. If no deal number is
available, and this field is populated, the transaction will be rejected. If deal
number is available and Exchange Rate is not populated, the transaction will
also be rejected.
Rate should be provided in American terms. Provided rates multiplied by
payment amount will equal US dollar amount that will be debited from your
account.
Up to 6 decimal places may be specified.
8 6.1.6 MemberIdentification MmbId Document/CstmrCdtTrfIText 1 35 1 1 The non-SWIFT Bank Identifier associated to the bank/branch holding the
Creditor Account.
If US ABA number is populated either populate "USABA" in the
CdtrAgt/FinInstnId/ClrSysMmbId/ClrSysId/Cd field or populate "FW" in the
CdtrAgt/FinInstnId/ClrSysMmbId/ClrSysId/Prtry field.
6 9.1.1 PostalAddress PstlAdr Document/CstmrCdtTrfIn 0 1 Unstructured address lines will be used for Wire.
7 9.1.11 AddressLine AdrLine Document/CstmrCdtTrfIn
Text 1 70 0 7 Free-form Street address of the Creditor. Unstructured address lines 1-3 will
be used for Fed Wire. U.S. Bank will use the first 35 characters on each line.
Only Unstructured address should be populated for Wires.
9 Ccy Document/CstmrCdtTrfIAttribute 1 1 Valid ISO currency for Tax Amount, Interest Amount or Penalty Amount. If C C
corresponding amount is populated, Ccy must be populated.
R R
R R
R R
O O
R R
C C
C C
O O
R R
R R
TRF TRF
O O
O O
R R
URGP URGP
R R
R R
R R
O O
R R
O O
R R
R R
O O
O O
R R
O O
O O
R R
O O
C C
R R
R R
O O
O O
C C
O O
O O
O O
O O
C C
O O
O O
O O
C C
C
C C
C C
O O
R R
O O
R R
O O
C C
C C
O O
O O
PERMITTED CHARACTERS
SWIFT
Any letter or number is acceptable.
Acceptable special characters on SWIFT:
Regular parentheses ( )
Period .
Dash/hyphen -
Plus sign +
Colon :
Apostrophes '
Comma ,
Back slash \
Question mark ?
Fedwire
Any letter or number is acceptable.
Non-printable characters are not allowed.
Acceptable special characters:
Regular parentheses ( )
Dash/hyphen -
Plus sign +
Equals =
Colon :
Semi-colon ;
Quotation Mark "
Comma ,
Period .
Back slash \
Forward slash /
Question mark ?
Exclamation mark !
Dollar sign $
Pound/number #
Percent %
Underscore _
Grave Accent `
Less than <
Greater than >
The following characters can be used but it would be best to leave out, unless
there is a specific instruction in the Implementation Guide to use them:
Quotation Mark "
Pound/number #
Colon :
Semi-colon ;
Question mark ?
Less than <
Greater than >
Equals =
Back slash \
Forward slash /
Circumflex ^
Underscore _
Grave Accent `
Opening Square Bracket [
Closing Square Bracket ]
Opening Brace {
Closing Brace }
Vertical Line |