Authenticate user

This endpoint requires an application API token.

Authentication

requestTokenstring
API Key authentication via header

Path parameters

providerstringRequired

Auth provider. This fields is optional and defaults to null for the built-in provider.

Request

This endpoint expects an object.
emailstringOptionalformat: "email"<=320 characters
Email address.
entrystringOptional

Identifier for entry point originating the request (used by front-end apps)

entryTypeintegerOptional

Type of entry identifier: 0 - partner, 2 - paypoint. This is used by front-end apps, required if an Entry is indicated.

pswstringOptional
userIdlongOptional
userTokenIdstringOptional

Response

Success
responseTextstring

Response text for operation: ‘Success’ or ‘Declined’.

isSuccessboolean or null

Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.

mfaboolean or null

When true, multi-factor authentication (MFA) is enabled.

mfaModestring or null

The mode of multi-factor authentication used.

mfaValidationCodestring or null

The validation code for multi-factor authentication, typically a hash or similar encrypted format.

responseDatastring or null
Data returned by the response, masked for security.

Errors