pain.001.001.09 format
Last updated
Last updated
LHV is using custom version of pain.001.001.09.xsd
XML rules
Multiplicity (MULT.) Informs how many times an element can or must be used, as defined by ISO standard.
1..1 One occurrence (required)
1..n One or several occurrences (value for βnβ represents total number of occurrences)
1..3 Minimum one occurrence must be used and maximum 3 occurrences can be used. Note: True value of βnβ represents unlimited number of occurrences.
0..1 None or one occurrence to be used (optional)
0..n None or several occurrences can be used (value for βnβ represents total number of occurrences). Note: True value of βnβ represents unlimited number of occurrences.
Message structure
Group Header β mandatory, occurs once. Payment Information β mandatory and repetitive. Contains information related to mostly the debit side of the payment. Credit Transfer Transaction Information β mandatory and repetitive. Contains information related to the payment(s) included in the message.
Message root
MULT. | MESSAGE ELEMENT | XML TAG |
---|---|---|
Group header
MULT. | OR | MESSAGE ELEMENT | XML TAG | LHV REQUIREMENT |
---|---|---|---|---|
Payment information
Common address structure is used throughout the payment initiation message. If PostalAddress is used then minimum Country and Town Name must be present. Some additional requirements apply:
Debtor address - For Virtual IBAN or agency banking account - the holder country
Ultimate debtor address - In case of FPSPOO and address line is filled, country must be filled
Ultimate debtor address - In case of FPSPOO and town name is filled, then country must be filled.
If creditorΒ΄s bank locates outside EEA address information is mandatory from 23.11.2024. The rule applies to all parties (debtor, ultimate debtor, creditor etc).
If creditorΒ΄s bank locates in EEA but the currency is not official currency in any EEA country (for example USD) - address information is mandatory from 23.11.2024. The rule applies to all parties (debtor, ultimate debtor, creditor etc).
If payment is processed as TARGET2 (See https://partners.lhv.ee/en/connect/#code-set-payment-scheme) - address information is mandatory from 01.03.2024. The rule applies to all parties (debtor, ultimate debtor, creditor etc).
Additional data can be added to the payment using SplmtryData element. Supplementary data block is encapsulated in XSD envelope (field Envlp) which may contain any additional structure of data.
LHV uses additional structure defined in supl.001.001.01.xsd. For proper XML validation the schema reference should be provided in pain.001.001.09 XML message header. For example:
Supplementary data includes additional data elements defined in 3 fields.
party - party that given data element is related to (e.g. CREDITOR, DEBTOR)
key - data element key (see below for supported values)
value - value for given data element (e.g. 1986-02-05)
Supllementary data key's:
pain.001 supplementary data example:
MULT. | OR | MESSAGE ELEMENT | XML TAG | LHV REQUIREMENT |
---|---|---|---|---|
MULT. | OR | MESSAGE ELEMENT | XML TAG | LHV REQUIREMENT |
---|---|---|---|---|
Key | Value/format | Usage description |
---|---|---|