The Account Information consent API performs the PSU authentication and returns a consent resource identifier that will allow you to access the ASPSP accounts that the PSU have provided consent to access.
This API intends to provide an interface to access PSD2 Consent services.
The API is designed on a REST model using JSON structures.
Paths
/{aspsp-cde}/v1-0-3/consents
Account Information Consent Request
Creates an account information consent resource at the ASPSP regarding access to accounts specified in this request.
When this Consent Request is a request where the "recurringIndicator" equals “true”, and if it exists already a former consent for recurring access on account information for the addressed PSU, then the former consent automatically expires as soon as the new consent request is authorised by the PSU.
ID of the transaction as determined by the initiating party.
{
"default": ""
}ID of the request, unique to the call, as determined by the initiating party.
{
"default": ""
}User identification in ASPSP
{
"default": ""
}Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility.
{
"default": ""
}The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP.
{
"default": ""
}The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.
{
"default": ""
}The forwarded Geo Location of the corresponding http request between PSU and TPP if available.
{
"pattern": "^GEO:[-?+?(\\d){1,3}.(\\d){6}]{8,11};[-?+?(\\d){1,3}.(\\d){6}]{8,11}$",
"default": "GEO:1.111111;-1.111111"
}UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available. UUID identifies either a device or a device dependant application installation. In case of an installation identification this ID need to be unaltered until removal from device.
{
"default": ""
}Fingerprint of the device used in the request between PSU and TPP, if available.
{
"default": ""
}Only used for Delegated Authentication Approach. \n "NSCA" - "SCA Not performed"; \n "SUCC" - "SCA Performed with Success"; \n If this data element is not used, there is no information about transaction SCA authentication
{
"enum": [
"NSCA",
"SUCC"
]
}Corporate User identification in ASPSP
{
"default": ""
}Might be mandated in the ASPSPs documentation. Only used in a corporate context.
{
"default": ""
}The forwarded Agent header field of the http request between PSU and TPP.
{
"default": ""
}URI of the TPP, where the transaction flow shall be redirected to after a Redirect. Shall be contained at least if the tppRedirectPreferred parameter is set to true or is missing.
{
"default": ""
}If it equals "true", the TPP requests a delegated SCA approach. If it equals "false", the TPP do not request a delegated SCA approach. If the parameter is not used, the TPP do not request a delegated SCA approach.
An identification provided by the ASPSP for the later identification of the authentication delegated.
{
"default": ""
}A signature of the request by the TPP on application level. This might be mandated by ASPSP.
{
"default": ""
}Hash of the message body. Should be present when Request body exists
{
"default": ""
}The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.
{
"default": ""
}Request date
Identification of the aspsp
{
"default": ""
}If it equals “true”, the TPP prefers a redirect over an embedded SCA approach. If it equals “false”, the TPP prefers not to be redirected for SCA. The ASPSP will then choose between the Embedded or the Decoupled SCA approach, depending on the choice of the SCA procedure by the TPP/PSU. If the parameter is not used, the ASPSP will choose the SCA approach to be applied depending on the SCA method chosen by the TPP/PSU.
{
"default": false
}Account Consent Request
{
"schema": {
"description": "Creates an account information consent resource at the ASPSP regarding access to accounts specified in this request.",
"type": "object",
"required": [
"access",
"recurringIndicator",
"validUntil",
"frequencyPerDay",
"combinedServiceIndicator"
],
"properties": {
"access": {
"description": "Requested access services. Only the sub attributes with the tags \"accounts\", \"balances\" and \"transactions\" are accepted for this request.",
"$ref": "#\/definitions\/AccountAccess"
},
"recurringIndicator": {
"description": "\"true\", if the consent is for recurring access to the account data.\n\"false\", if the consent is for one access to the account data.\n",
"type": "boolean",
"default": false
},
"validUntil": {
"description": "This parameter is requesting a valid until date for the requested consent. The content is the local ASPSP date in ISODate Format.\n",
"type": "string",
"format": "date-time",
"default": "1900-01-01T00:00:00Z"
},
"frequencyPerDay": {
"description": "This field indicates the requested maximum frequency for an access per day. For a one-off access, this attribute is set to \"1\".\n",
"type": "integer",
"format": "int32",
"minimum": 1,
"default": 1
},
"combinedServiceIndicator": {
"description": "If \"true\" indicates that a payment initiation service will be addressed in the same \"session\".",
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
}This parameter may only be used together with the access sub attribute “available-accounts” in the request body. \n\nThe request is rejected if the ASPSP is not NextGenPSD2 supporting this parameter.\n\nIf the ASPSP accepts this parameter in the /consents endpoint, he shall also accept it for the GET access method on the /accounts endpoint.\n
{
"default": false
}Created
Bad Request.
Unauthorized.
Forbidden.
Not Found.
Method Not Allowed.
Not Acceptable.
Request Timeout.
Unsupported Media Type.
Too Many Requests.
Internal Server Error.
Service Unavailable.
Gatewaty Timeout.
/{aspsp-cde}/v1-0-3/consents/{consent-id}
Get Consent Request
Returns the content of an account information consent object.
ID of the transaction as determined by the initiating party.
{
"default": ""
}ID of the request, unique to the call, as determined by the initiating party.
{
"default": ""
}User identification in ASPSP
{
"default": ""
}Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility.
{
"default": ""
}Corporate User identification in ASPSP
{
"default": ""
}Might be mandated in the ASPSPs documentation. Only used in a corporate context.
{
"default": ""
}A signature of the request by the TPP on application level. This might be mandated by ASPSP.
{
"default": ""
}Hash of the message body. Should be present when Request body exists
{
"default": ""
}The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.
{
"default": ""
}Request date
Identification of the aspsp
{
"default": ""
}Identification of the consent
{
"default": ""
}Bad Request.
Unauthorized.
Forbidden.
Not Found.
Method Not Allowed.
Not Acceptable.
Request Timeout.
Unsupported Media Type.
Too Many Requests.
Internal Server Error.
Service Unavailable.
Gatewaty Timeout.
Update PSU Data
Updates the account information consent data.
ID of the transaction as determined by the initiating party.
{
"default": ""
}ID of the request, unique to the call, as determined by the initiating party.
{
"default": ""
}User identification in ASPSP
{
"default": ""
}Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility.
{
"default": ""
}Corporate User identification in ASPSP
{
"default": ""
}Might be mandated in the ASPSPs documentation. Only used in a corporate context.
{
"default": ""
}A signature of the request by the TPP on application level. This might be mandated by ASPSP.
{
"default": ""
}Hash of the message body. Should be present when Request body exists
{
"default": ""
}The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.
{
"default": ""
}Request date
Identification of the aspsp
{
"default": ""
}Identification of the consent
{
"default": ""
}Account Consent Request Update
{
"schema": {
"description": "Update information related to a previous consent request in order to obtain PSUId credentials.\nIt is only to be used to support Embedded method.",
"type": "object",
"properties": {
"psuData": {
"$ref": "#\/definitions\/PSUData",
"description": "Include all credentials related data"
},
"scaAuthenticationData": {
"description": "SCA authentication data, depending on the chosen authentication method. \n\nif the data is binary, then it is base64 encoded.\n",
"type": "string",
"default": ""
},
"authenticationMethodId": {
"description": "The authentication method ID as provided by the ASPSP\n\nThis property is mandatory in a Select Authentication Method\n",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
}Bad Request.
Unauthorized.
Forbidden.
Not Found.
Method Not Allowed.
Not Acceptable.
Request Timeout.
Unsupported Media Type.
Too Many Requests.
Internal Server Error.
Service Unavailable.
Gatewaty Timeout.
Delete an Account Information Consent Object
Deletes a given consent.
ID of the transaction as determined by the initiating party.
{
"default": ""
}ID of the request, unique to the call, as determined by the initiating party.
{
"default": ""
}A signature of the request by the TPP on application level. This might be mandated by ASPSP.
{
"default": ""
}Hash of the message body. Should be present when Request body exists
{
"default": ""
}The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.
{
"default": ""
}Request date
Identification of the aspsp
{
"default": ""
}Identification of the consent
{
"default": ""
}No Content
Bad Request.
Unauthorized.
Forbidden.
Not Found.
Method Not Allowed.
Not Acceptable.
Request Timeout.
Unsupported Media Type.
Too Many Requests.
Internal Server Error.
Service Unavailable.
Gatewaty Timeout.
/{aspsp-cde}/v1-0-3/consents/{consent-id}/status
Get Status Request
Check the status of an account information consent resource.
ID of the transaction as determined by the initiating party.
{
"default": ""
}ID of the request, unique to the call, as determined by the initiating party.
{
"default": ""
}User identification in ASPSP
{
"default": ""
}Type of the PSU-ID, needed in scenarios where PSUs have several PSU-IDs as access possibility.
{
"default": ""
}Corporate User identification in ASPSP
{
"default": ""
}Might be mandated in the ASPSPs documentation. Only used in a corporate context.
{
"default": ""
}A signature of the request by the TPP on application level. This might be mandated by ASPSP.
{
"default": ""
}Hash of the message body. Should be present when Request body exists
{
"default": ""
}The certificate used for signing the request, in base64 encoding. Shall be contained if the signature is used.
{
"default": ""
}Request date
Identification of the aspsp
{
"default": ""
}Identification of the consent
{
"default": ""
}Bad Request.
Unauthorized.
Forbidden.
Not Found.
Method Not Allowed.
Not Acceptable.
Request Timeout.
Unsupported Media Type.
Too Many Requests.
Internal Server Error.
Service Unavailable.
Gatewaty Timeout.
Definitions
Defines the properties of an account data consent request.
{
"type": "object",
"properties": {
"accounts": {
"description": "Is asking for detailed account information. If the array is empty, the TPP is asking for an accessible account list. This may be restricted in a PSU/ASPSP authorization dialogue.\n",
"$ref": "#/definitions/AccountReferenceArray"
},
"balances": {
"description": "Is asking for balances of the addressed accounts. If the array is empty, the TPP is asking for the balances of all accessible account lists. This may be restricted\n",
"$ref": "#/definitions/AccountReferenceArray"
},
"transactions": {
"description": "Is asking for balances of the addressed accounts. If the array is empty, the TPP is asking for the balances of all accessible account lists. This may be restricted\n",
"$ref": "#/definitions/AccountReferenceArray"
},
"availableAccounts": {
"description": "Only the value \"all-accounts\" is admitted.",
"default": "",
"$ref": "#/definitions/AvailableAccountsEnum"
},
"allPsd2": {
"description": "Only the value \"all-accounts\" is admitted.",
"default": "",
"$ref": "#/definitions/AllPsd2Enum"
},
"authDelegation": {
"description": "Only the value \"selected-accounts\" is admitted.",
"default": "",
"$ref": "#/definitions/AuthDelegationEnum"
}
},
"minProperties": 1,
"additionalProperties": false
}
Identifier of the addressed account.
{
"type": "object",
"required": [
"iban"
],
"properties": {
"iban": {
"description": "International Bank Account Number",
"type": "string",
"pattern": "^[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}$",
"default": "PT0000"
},
"bban": {
"description": "This data elements is used for payment accounts which have no IBAN.",
"type": "string",
"default": ""
},
"pan": {
"description": "Primary Account Number (PAN) of a card, can be tokenised by the ASPSP due to PCI DSS requirements.",
"type": "string",
"maxLength": 35,
"default": ""
},
"maskedPan": {
"description": "Primary Account Number (PAN) of a card in a masked form.",
"type": "string",
"maxLength": 35,
"default": ""
},
"msisdn": {
"description": "An alias to access a payment account via a registered mobile phone number",
"type": "string",
"maxLength": 35,
"default": ""
},
"currency": {
"description": "ISO 4217 Alpha 3 currency code.",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Array of Account References applicable to a consent.
{
"type": "array",
"items": {
"$ref": "#/definitions/AccountReference",
"additionalProperties": false
}
}
Only the value "allAccounts" is admitted.
{
"type": "string",
"enum": [
"all-accounts"
],
"default": "all-accounts",
"additionalProperties": false
}
Authentication Data.
{
"type": "object",
"required": [
"authenticationType",
"authenticationMethodId"
],
"properties": {
"authenticationType": {
"description": "Type of the authentication method.",
"$ref": "#/definitions/AuthenticationType"
},
"authenticationVersion": {
"description": "Depending on the authenticationType. This version can be used by differentiating authentication tools used within performing OTP generation in the same authentication type. This version can be referred to in the ASPSP’s documentation.\n",
"type": "string",
"default": ""
},
"authenticationMethodId": {
"description": "An identification provided by the ASPSP for the later identification of the authentication method selection.\n",
"type": "string",
"maxLength": 35,
"default": ""
},
"name": {
"description": "This is the name of the authentication method defined by the PSU in the Online Banking frontend of the ASPSP. Alternatively this could be a description provided by the ASPSP like “SMS OTP on phone +49160 xxxxx 28”. This name shall be used by the TPP when presenting a list of authentication methods to the PSU, if available.\n",
"type": "string",
"default": ""
},
"explanation": {
"description": "detailed information about the sca method for the PSU.\n",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Authentication Data.
{
"type": "array",
"items": {
"$ref": "#/definitions/Authentication"
},
"additionalProperties": false
}
authentication types: SMS_OTP - An SCA method, where an OTP linked to the transaction to be authorised is sent to the PSU through a SMS channel. CHIP_OTP - An SCA method, where an OTP is generated by a chip card, e.g. an TOP derived from an EMV cryptogram. To contact the card, the PSU normally needs a (handheld) device. With this device, the PSU either reads the challenging data through a visual interface like flickering or the PSU types in the challenge through the device key pad. The device then derives an OTP from the challenge data and displays the OTP to the PSU. PHOTO_OTP - An SCA method, where the challenge is a QR code or similar encoded visual data which can be read in by a consumer device or specific mobile app. The device resp. the specific app than derives an OTP from the visual challenge data and displays the OTP to the PSU. PUSH_OTP - An OTP is pushed to a dedicated authentication APP and displayed to the PSU.
{
"type": "string",
"enum": [
"SMS_OTP",
"CHIP_OTP",
"PHOTO_OTP",
"PUSH_OTP"
],
"default": "SMS_OTP",
"additionalProperties": false
}
Only the value "allAccounts" is admitted.
{
"type": "string",
"enum": [
"all-accounts"
],
"default": "all-accounts",
"additionalProperties": false
}
Only the value "selected-accounts" is admitted.
{
"type": "string",
"enum": [
"selected-accounts"
],
"default": "selected-accounts",
"additionalProperties": false
}
Requested Authentication Data
{
"type": "object",
"properties": {
"image": {
"description": "PNG data (max. 512 kilobyte) to be displayed to the PSU, Base64 encoding , cp. [RFC 4648]. This attribute is used only, when PHOTO_OTP or CHIP_OTP is the selected SCA method.\n",
"type": "string",
"format": "byte",
"default": ""
},
"data": {
"description": "String challenge data",
"type": "string",
"default": ""
},
"imageLink": {
"description": "A link where the ASPSP will provides the challenge image for the TPP.",
"type": "string",
"default": ""
},
"otpMaxLength": {
"description": "The maximal length for the OTP to be typed in by the PSU.",
"type": "number",
"default": 0
},
"otpFormat": {
"description": "The format type of the OTP to be typed in.",
"type": "string",
"enum": [
"characters",
"integer"
],
"default": "characters"
},
"additionalInformation": {
"description": "Additional explanation for the PSU to explain e.g. fallback mechanism for the chosen SCA method. The TPP is obliged to show this to the PSU.",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Returns the content of an account information consent object.
{
"type": "object",
"required": [
"access",
"recurringIndicator",
"validUntil",
"frequencyPerDay",
"lastActionDate",
"transactionStatus",
"consentStatus"
],
"properties": {
"access": {
"description": "Requested access services.",
"$ref": "#/definitions/AccountAccess"
},
"recurringIndicator": {
"description": "True, if the consent is for recurring access to the account data False, if the consent is for one access to the account data",
"type": "boolean",
"default": false
},
"validUntil": {
"description": "Requested validity ISODate for the consent.",
"type": "string",
"format": "date-time",
"default": "1900-01-01T00:00:00Z"
},
"frequencyPerDay": {
"description": "Requested Maximum Frequency for an Access per Day.",
"type": "integer",
"format": "int32",
"default": 0
},
"lastActionDate": {
"description": "This date is containing the date of the last action on the consent object either through the XS2A interface or the PSU/ASPSP interface having an impact on the status.\n",
"type": "string",
"format": "date",
"default": "1900-01-01"
},
"transactionStatus": {
"description": "This is the “authentication status” of the consent.",
"$ref": "#/definitions/TransactionStatusType"
},
"consentStatus": {
"description": "The status of the consent resource.",
"type": "string",
"enum": [
"empty",
"valid",
"blocked",
"expired",
"deleted"
],
"default": "empty"
}
},
"additionalProperties": false
}
Creates an account information consent resource at the ASPSP regarding access to accounts specified in this request.
{
"type": "object",
"required": [
"access",
"recurringIndicator",
"validUntil",
"frequencyPerDay",
"combinedServiceIndicator"
],
"properties": {
"access": {
"description": "Requested access services. Only the sub attributes with the tags \"accounts\", \"balances\" and \"transactions\" are accepted for this request.",
"$ref": "#/definitions/AccountAccess"
},
"recurringIndicator": {
"description": "\"true\", if the consent is for recurring access to the account data.\n\"false\", if the consent is for one access to the account data.\n",
"type": "boolean",
"default": false
},
"validUntil": {
"description": "This parameter is requesting a valid until date for the requested consent. The content is the local ASPSP date in ISODate Format.\n",
"type": "string",
"format": "date-time",
"default": "1900-01-01T00:00:00Z"
},
"frequencyPerDay": {
"description": "This field indicates the requested maximum frequency for an access per day. For a one-off access, this attribute is set to \"1\".\n",
"type": "integer",
"format": "int32",
"minimum": 1,
"default": 1
},
"combinedServiceIndicator": {
"description": "If \"true\" indicates that a payment initiation service will be addressed in the same \"session\".",
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}
Update information related to a previous consent request in order to obtain PSUId credentials. It is only to be used to support Embedded method.
{
"type": "object",
"properties": {
"psuData": {
"$ref": "#/definitions/PSUData",
"description": "Include all credentials related data"
},
"scaAuthenticationData": {
"description": "SCA authentication data, depending on the chosen authentication method. \n\nif the data is binary, then it is base64 encoded.\n",
"type": "string",
"default": ""
},
"authenticationMethodId": {
"description": "The authentication method ID as provided by the ASPSP\n\nThis property is mandatory in a Select Authentication Method\n",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Hyperlinks to be recognised by the TPP. The actual hyperlinks used in the response depend on the dynamical decisions of the ASPSP when processing the request.
{
"type": "object",
"properties": {
"redirect": {
"description": "In case of an SCA Redirect Approach, the ASPSP is transmitting the link to which to redirect the PSU browser.\n",
"type": "string",
"default": ""
},
"updatePsuIdentification": {
"description": "The link to the payment initiation resource, which needs to be updated by the PSU identification. This might be used in a redirect or decoupled approach, where the PSU ID was missing in the first request.\n",
"type": "string",
"default": ""
},
"updatePsuAuthenication": {
"description": "The link to the account information resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet. This is used in a case of the Embedded SCA approach.\n",
"type": "string",
"default": ""
},
"selectAuthenticationMethod": {
"description": "This is a link to a resource, where the TPP can select the applicable SCA for the PSU, if there were several available authentication methods. This link is only contained under exactly the same conditions as the data element “authenticationMethods”, see above.\n",
"type": "string",
"default": ""
},
"authoriseTransaction": {
"description": "The link to the payment initiation or consent resource, where the “Transaction Authorisation”Request” is sent to.\nThis is the link to the resource which will authorise the payment or the consent by checking the SCA authentication data within the Embedded SCA approach.\n",
"type": "string"
},
"status": {
"description": "The link to retrieve the transaction status of the account information consent.\n",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
A list of hyperlinks to be recognized by the TPP.
Might be contained, if several authentication methods are available for the PSU.
{
"properties": {
"selectAuthenticationMethod": {
"description": "This is a link to a resource, where the TPP can select the applicable second factor authentication methods for the PSU, if there were several available authentication methods.\n",
"type": "string",
"default": ""
},
"authoriseTransaction": {
"description": "The link to the resource, where the \"Transaction Authorisation Request\" is sent to. This is the link to the resource which will authorise the transaction by checking the SCA authentication data within the Embedded SCA approach.\n",
"type": "string",
"default": ""
},
"self": {
"description": "The link to the resource itself.\n",
"type": "string",
"default": ""
},
"status": {
"description": "The link where the transaction status of the resoure can be retrieved.",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Informs TPP about an account information consent resource.
{
"type": "object",
"required": [
"transactionStatus",
"_links"
],
"properties": {
"transactionStatus": {
"description": "authentication status of the consent.",
"$ref": "#/definitions/TransactionStatusType"
},
"consentId": {
"description": "Identification of the consent resource as it is used in the API structure Shall be contained, if a consent resource was generated.\n",
"type": "string",
"default": ""
},
"scaMethods": {
"description": "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods. Depending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified with the first relevant factor, or if an access token is transported. If this data element is contained, then there is also an hyperlink of type \"selectAuthenticationMethods\" contained in the response body. These methods shall be presented towards the PSU for selection by the TPP.\n",
"items": {
"type": "string"
},
"$ref": "#/definitions/AuthenticationArray"
},
"chosenScaMethod": {
"description": "This data element is only contained in the response if the APSPS has chosen the Embedded SCA Approach, if the PSU is already identified with the first relevant factor or alternatively an access token, if SCA is required and if the authentication method is implicitly selected.\n",
"$ref": "#/definitions/Authentication"
},
"challengeData": {
"description": "It is containded in addition to the data element chosenScaMethod if challenge data is needed for SCA. In rare cases this attribute is also used in the context of the psuAuthentication link.\n",
"$ref": "#/definitions/Challenge"
},
"_links": {
"description": "A list of hyperlinks to be recognised by the TPP.\n",
"$ref": "#/definitions/ConsentResponseLink"
},
"psuMessage": {
"description": "Text to be displayed to the PSU, e.g. in a Decoupled SCA Approach\n",
"type": "string",
"default": ""
},
"delegationId": {
"description": "An identification provided by the ASPSP for the later identification of the authentication delegated.\n",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Informs TPP about status of an account information consent resource.
{
"type": "object",
"required": [
"transactionStatus"
],
"properties": {
"transactionStatus": {
"description": "Authentication status of the consent.",
"$ref": "#/definitions/TransactionStatusType"
}
},
"additionalProperties": false
}
Response related to a previous consent update request. It is only to be used to support Embedded method.
{
"type": "object",
"required": [
"transactionStatus"
],
"properties": {
"chosenScaMethod": {
"$ref": "#/definitions/Authentication",
"description": "If the ASPSP has chosen the Embedded SCA Approach, if the PSU is already identified e.g. with the first relevant factor or alternatively an access token, if SCA is required and if the authentication method is implicitly selected."
},
"challengeData": {
"$ref": "#/definitions/Challenge",
"description": "It is contained in addition to the data element \"chosenScaMethod\" if challenge data is needed for SCA."
},
"scaMethods": {
"$ref": "#/definitions/AuthenticationArray",
"description": "This data element might be contained, if SCA is required and if the PSU has a choice between different authentication methods. Depending on the risk management of the ASPSP this choice might be offered before or after the PSU has been identified with the first relevant factor, or if an access token is transported. If this data element is contained, then there is also an hyperlink of type \"startAuthorisationWith AuthenticationMethodSelection\" contained in the response body. These methods shall be presented towards the PSU for selection by the TPP."
},
"_links": {
"$ref": "#/definitions/ConsentUpdateLink",
"description": "Consent Update Link"
},
"transactionStatus": {
"$ref": "#/definitions/TransactionStatusType",
"description": "The transaction status is filled with codes of the ISO 20022 data table."
},
"psuMessage": {
"description": "Text to be displayed to the PSU",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Error Information.
{
"type": "object",
"properties": {
"tppMessages": {
"$ref": "#/definitions/TppMessageArray",
"description": "Messages to the TPP on operational issues."
}
},
"additionalProperties": false
}
Error and status Information.
{
"type": "object",
"properties": {
"transactionStatus": {
"$ref": "#/definitions/TransactionStatusType",
"description": "The transaction status is filled with codes of the ISO 20022 corresponding element."
},
"tppMessages": {
"$ref": "#/definitions/TppMessageArray",
"description": "Messages to the TPP on operational issues."
}
},
"additionalProperties": false
}
Message error codes.
{
"type": "string",
"enum": [
"SERVICE_BLOCKED",
"CORPORATE_ID_IVALID",
"CONSENT_UNKNOWN",
"CONSENT_INVALID",
"CONSENT_EXPIRED",
"RESOURCE_UNIKNOWN",
"RESOURCE_EXPIRED",
"TIMESTAMP_INVALID",
"PERIOD_INVALID",
"SCA_METHOD_UNKKNOWN",
"TRANSACTION_ID_INVALID",
"PRODUCT_INVALID",
"PRODUCT_UNKNOWN",
"PAYMENT_FAILED",
"REQUIRED_KID_MISSING",
"SESSIONS_NOT_SUPPORTED",
"ACCESS_EXCEEDED",
"REQUESTED_FORMATS_INVALID",
"CARD_INVALID",
"NO_PIIS_ACTIVATION"
],
"default": "SERVICE_BLOCKED",
"additionalProperties": false
}
The password or encryptedPassword subfield is used, depending on encryption requirements of the ASPSP as indicated in the corresponding hyperlink contained in the last response message of the ASPSP.
{
"type": "object",
"properties": {
"password": {
"description": "PSU Password.",
"type": "string",
"default": ""
}
},
"additionalProperties": false
}
Transports additional error information.
{
"required": [
"category",
"code"
],
"properties": {
"category": {
"type": "string",
"default": "",
"description": "Category of the error. Only \"ERROR\" or \"WARNING\" permitted."
},
"code": {
"$ref": "#/definitions/MessageCode",
"description": "Message error code."
},
"path": {
"type": "string",
"default": "",
"description": "Path of the element of the request message which provoked this error message."
},
"text": {
"type": "string",
"maxLength": 512,
"default": "",
"description": "Additional explaining text."
}
},
"additionalProperties": false
}
Messages to the TPP on operational issues.
{
"type": "array",
"items": {
"$ref": "#/definitions/TppMessage",
"description": "Transports additional error information."
},
"additionalProperties": false
}
ISO20022: The transaction status is filled with value of the ISO20022 data table. RCVD : RECEIVED PDNG : PENDING PATC : PARTIALLY ACCEPTED TECHNICAL CORRECT ACTC : ACCEPTED TECHNICAL VALIDATION RJCT : REJECTED
{
"type": "string",
"enum": [
"RCVD",
"PDNG",
"PATC",
"ACTC",
"RJCT"
],
"default": "RJCT",
"additionalProperties": false
}