ARS — Address Resolution Service

ClassifyPartyAddressRequest

object

EP-06 request. Lightweight classification only — no repair.

channelNamestring
postalAddressobject

ISO 20022 PostalAddress24 object. All 14 structured fields are supported.
Country is strongly recommended for all submissions.
AddressLine is limited to max 7 elements in schema; practical publishing limits
are governed by OutputMode (EPC=2, CBPR_PLUS=3, MT_LEGACY=2, COMPLIANCE=7).
PMPG non-duplication rule: structured fields (TownName, Country) must NOT also
appear in AddressLine simultaneously.

Show Child Parameters
postalAddressXmlobject

ISO 20022 XML tag equivalents of PostalAddress. Alternative input format — clients
may supply either postalAddress (JSON) or postalAddressXml (XML tag names), not both.

Show Child Parameters
contextobject

Analytics only for this endpoint — no processing fallback.

Show Child Parameters
Example

ClassifyPartyAddressResponse

object
formatstring

Detected or target address format classification.

Allowed values:FULLY_STRUCTUREDHYBRIDFULLY_UNSTRUCTURED

hasAddressLineboolean
addressLineCountinteger
hasStructuredFieldsboolean
hasTownNameboolean
hasCountryboolean
Example

RTransactionPartyAddressRequest

object

EP-07 request. R-transaction address exemption assessment.

channelNamestring
postalAddressobjectrequired

The exact address as it appears in the R-message. Must not be altered.

Show Child Parameters
originalExecutionDatetimestring(date-time)

When the original payment was executed. Determines SR2026 exemption eligibility.

processingOptionsobject

Per-request overrides of the channelProfile configuration. Only fields present
here override the corresponding channelProfile value. Fields absent here fall
through to channelProfile. This is NOT a general-purpose configuration block —
it only overrides values already set in channelProfile.

Show Child Parameters
contextobject

Analytics/audit passthrough AND processing fallback layer.
Fields labelled “Analytics + Processing fallback” are used as last-resort defaults
when both channelProfile and processingOptions leave a parameter unresolved.
Pure analytics fields are written to the ARS audit log but do not affect processing.
Processing precedence: channelProfile → processingOptions → context.

Show Child Parameters
Example

RTransactionPartyAddressResponse

object
decisionstring

Top-level processing decision.

Allowed values:ACCEPTREJECTPARTIAL_SUCCESS

rTransactionContextobject

R-transaction exemption assessment result.

Show Child Parameters
resultobject

Address exactly as submitted — NO repair is applied.

Show Child Parameters
statisticsobject

Processing statistics block returned on all endpoints.

Show Child Parameters
timestampstring(date-time)
Example

MessageRequestBase

object

Common fields shared by all Layer 2 message-level endpoints.

channelNamestring

Name of a registered channelProfile. Loads scheme, direction, outputMode, and other defaults.

executionDatetimestring(date-time)

Transaction execution datetime for SR2026 cutover enforcement.

messageContentobject

JSON equivalent of the ISO 20022 message. One of messageContent or messageXml required.

messageXmlstring

Raw ISO 20022 XML string. Takes precedence over messageContent if both provided.

processingOptionsobject

Per-request overrides of the channelProfile configuration. Only fields present
here override the corresponding channelProfile value. Fields absent here fall
through to channelProfile. This is NOT a general-purpose configuration block —
it only overrides values already set in channelProfile.

Show Child Parameters
contextobject

Analytics/audit passthrough AND processing fallback layer.
Fields labelled “Analytics + Processing fallback” are used as last-resort defaults
when both channelProfile and processingOptions leave a parameter unresolved.
Pure analytics fields are written to the ARS audit log but do not affect processing.
Processing precedence: channelProfile → processingOptions → context.

Show Child Parameters
includearray[string]
Example