Accounts Authentication

To authenticate against an external system a set of credentials is typically used. Those credentials are stored in PDX as Accounts - a configurable set of credentials collected under single Account ID.

There are two options of

📘

Note that the password attribute is missing from the attributes on accounts list view. Password attributes are only visible when a new account is added or an old one is modified.

Accounts consists of a number of attributes:

  • Account Identifier (PDX identifier of an account entity added by default) - does not have to be specified separately
  • Other channel-specific attributes (see example Vendor Id and Vendor Number on image above)

More on the process of defining Account Attributes can be found in Required-client-attributes.

🚧

It is in general required to store those credentials in the adapter as they will be required in submission process to authenticate against an external system.

AuthenticationRequest object contains clientId, channelId and accountId which should be used as a key, these values are also provided when processing submission - see submitBatch methods of SubmitHandlers described in Submission-Modes.