Interface Description

The purpose of the interface description is to explain the communication between private sector account brokers and the NemKonto system. The IT systems that need to perform account lookups in the NemKonto system must use this interface.

The target audience for the interface description is private sector account brokers who, either themselves or on behalf of a private sector payer, want to communicate with the NemKonto system.

The description is intended for IT suppliers (both internal and external) who need to adapt IT systems to communicate with the NemKonto system via this interface.

If you want to read more about the interfaces between private sector account brokers and the NemKonto system, you can request the document from NemKonto Support.

Contact NemKonto Support via the contact form.

When a private sector account broker performs an account lookup in the NemKonto system, it must be done in the correct and approved OIOXML format.

The NemKonto system returns the account information in OIOXML format, and the responses can include various types of answers.

Among others:

• Domestic NemKonto found

• Foreign NemKonto found

• No NemKonto found

• Error in XML format

There are several examples of response messages.

Each response has a unique status code that refers to a specific error code. You can read more about error codes below.

If you, as a private sector account broker, wish to see OIOXML examples of account lookups and responses, you can request them by contacting NemKonto Support via the contact form.

When using the NemKonto system, private sector account brokers may receive a number of error codes.

The error codes are presented with a type, error code, and a description of each error.

An example of an error might be that the NemKonto system could not find a NemKonto in connection with an account lookup.

The overview of error codes is provided in connection with joining the NemKonto system.

If you want to see the full list of error codes, you can request the document from NemKonto Support via the contact form