Search
K
ARS — Address Resolution Service

EP-17 — Mandate Message Party Addresses

Message-level equivalent of EP-16. Evaluates every party address in the message
and returns addressMandatory, addressPresent, and addressCompliant for each.

addressCompliant reflects SR2026 rules regardless of schemeVersion — always forward-looking.
addressMandatory: true + addressPresent: false = compliance gap causing payment rejection.

Processing precedence: channelProfile → processingOptions → context.

post
https://api-uat.ionova.ai/ars/mandate-message-party-addresses

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Body

MandateMessageRequest

EP-17 request. Address mandate determination for all parties in message.

channelNamestring
executionDatetimestring(date-time)
messageContentobject
messageXmlstring
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

Provide sendingCountry and receivingCountry for accurate EEA mandate determination.

Show Child Parameters

Response

Message mandate assessment completed

MandateMessageResponse

messageTypestring

ISO 20022 message type. R-transaction types (pain.002, pain.007, pacs.002,
pacs.004, camt.029, camt.052, camt.053, camt.054, camt.055, camt.056, camt.058, camt.110, camt.111) must be submitted to R-transaction endpoints only
(EP-07, EP-15). Submitting them to Check/Convert endpoints returns HTTP 422 (REG-06).

Allowed values:pain.001pain.002pain.007pain.008pacs.002pacs.003pacs.004pacs.008pacs.009pacs.010camt.029camt.052camt.053camt.054camt.055camt.056camt.057camt.058camt.060camt.105camt.106camt.107camt.108camt.109camt.110camt.111

schemestring

Payment scheme identifier.

Allowed values:SCTSCT_INSTSDD_CORESDD_B2BOCT_INSTCBPRPLUSCHAPST2EURO1FEDWIREOTHER

partyMandatesarray[object]
Show Child Parameters
post/mandate-message-party-addresses

Body

{ "channelName": "MY_SEPA_SCT", "executionDatetime": "2026-10-15T10:00:00Z", "messageXml": "<Document>...</Document>", "context": { "sendingCountry": "CH", "receivingCountry": "DE" } }
 

Layer 4 — Reference

Read-only reference data. Cache aggressively — changes only with regulatory updates.

EP-18 — Countries

Returns all countries with SEPA/EEA membership and ISO 3166-1 alpha-2 codes.
30 EEA SEPA countries and 11 non-EEA SEPA countries/territories.
Non-EEA SEPA membership triggers mandatory payer address under EU Reg 2023/1113.
No request body or query parameters. Cache aggressively.

get
https://api-uat.ionova.ai/ars/countries

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Response

application/json

Country list returned

CountriesResponse

countriesarray[object]
Show Child Parameters
get/countries
 
application/json

EP-19 — Country Detail

Returns full country detail including PMPG element usage indicators for all
14 PostalAddress24 structured fields. Returns HTTP 404 if code not found.

get
https://api-uat.ionova.ai/ars/countries/{code}

Path Parameters

codestringrequired

ISO 3166-1 alpha-2 country code (e.g. DE, GB, CH)

Match pattern:^[A-Z]{2}$

Example:DE

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Response

application/json

Country detail returned

CountryDetailResponse

codestring

Match pattern:^[A-Z]{2}$

namestring
sepaMemberboolean
eeaMemberboolean
elementUsageobject

PMPG usage indicators for all 14 PostalAddress24 structured fields. M=Mandatory, E=Expected, O=Optional, C=Conditional, N=Not used.

Show Child Parameters
get/countries/{code}
 
application/json

EP-20 — Schemes

Returns all 11 payment schemes supported by ARS v4.3. No request body. Cache aggressively.

get
https://api-uat.ionova.ai/ars/schemes

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Response

application/json

Scheme list returned

SchemesResponse

schemesarray[object]
Show Child Parameters
get/schemes
 
application/json