openFinance API Framework XS2A API as PSD2 Interface Implementation Guidelines - Payment Initiation Service (2.3)

The Berlin Group - A European Standards Initiative | info@: info@berlin-group.org | URL: https://www.berlin-group.org/

License: Creative Commons Attribution 4.0 International Public License

The payment initiation flow depends heavily on the SCA approach implemented by the ASPSP. The most complex flow is the flow for the Embedded SCA Approach, which further differs on whether there are various authentication methods available for the PSU. In the following, the different API flows are provided as an overview for these different scenarios. Remark: The flows do not always cover all variances or complexities of the implementation and are exemplary flows.

Cancel payment

DELETE /v2/{payment-service}/{payment-product}/{paymentId}

Initiates the cancellation of a payment See "XS2A API as PSD2 Interface Implementation Guidelines ", section "Payment Cancellation Request".

Path parameters

Parameter	Type	Description
payment-service	string , required	Payment service. Only "payments" (single payments) is supported. Allowed values: payments Example: `payments`
payment-product	string , required	The addressed payment product endpoint. The following payment products are supported: - sepa-credit-transfers - instant-sepa-credit-transfers Allowed values: sepa-credit-transfers, instant-sepa-credit-transfers Example: `sepa-credit-transfers`
paymentId	string , required	Resource identification of the related payment. Example: `fe7552ee-0728-4bd1-baf7-94942331e478` Allowed length: max: 70

Header parameters

Header	Type	Description
PSU-User-Agent	string , optional	The forwarded Agent header field of the HTTP request between PSU and TPP, if available. Example: `Mozilla/5.0 (Windows NT 10.0; WOW64; rv:54.0) Gecko/20100101 Firefox/54.0`
PSU-Device-ID	string , optional	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 needs to be unaltered until removal from device. Example: `99435c7e-ad88-49ec-a2ad-99ddcb1f5555` Format: uuid
PSU-Geo-Location	string , optional	The forwarded Geo Location of the corresponding http request between PSU and TPP if available. Example: `GEO:52.506931;13.144558` Pattern: ^GEO:-?[0-9]{1,2}\.[0-9]{6};-?[0-9]{1,3}\.[0-9]{6}$
PSU-ID	string , optional	Client ID of the PSU in the ASPSP client interface. Might be mandated in the ASPSP's documentation. It might be contained even if an OAuth2 based authentication was performed in a pre-step or an OAuth2 based SCA was performed in an preceding AIS service in the same session. In this case the ASPSP might check whether PSU-ID and token match, according to ASPSP documentation. Example: `PSU-1234` Allowed length: max: 140
PSU-Corporate-ID	string , optional	Might be mandated in the ASPSP's documentation. Only used in a corporate context. Example: `PSU-CORP-ID1234` Allowed length: max: 140
Client-Redirect-URI	string , optional	URI the transaction flow returns to after a redirect. Required for the redirect SCA approach. Example: `https://exampleclient.com/redirectUri?clientEvent=11111111` Format: uri
Digest	string , optional	Integrity hash of the request body in the form `SHA-256=<base64>`. For an empty body, use the hash of an empty string. See Signing requests for how the Digest and signature are built. Example: `SHA-256=hl1/Eps8BEQW58FJhDApwJXjGY4nr1ArGDHIT25vq6A=`
x-jws-signature	string , optional	Detached JSON Web Signature over the signed request headers and body. See Signing requests for how it is constructed.
X-Request-ID	string , required	Unique ID of the request, set by the initiating party and echoed back in the response. Example: `99391c7e-ad88-49ec-a2ad-99ddcb1f7721` Format: uuid

Responses

Select a status code to see the structure and an example of the response.

Field	Type	Description
transactionStatus	string , required	ISO 20022 transaction status code. Allowed values: ACCC, ACCP, ACSC, ACSP, ACTC, ACWC, ACWP, RCVD, PDNG, RJCT, CANC, ACFC, PATC, PART, PRES, RVCM, RVNC, RCVC Example: `ACCC`
_links	object , optional	A list of hyperlinks to be recognised by the API Client. The actual hyperlinks used in the response depend on the dynamical decisions of the ASPSP when processing the request. The potential links for this response message are generically defined in [oFA SMPF] for all Transaction Initiation Response messages or response message for other requests which need authorisation. These links will also be contained in the related Open API files. Remark: All links can be relative or full links, to be decided by the ASPSP.
self	object , optional	A hyperlink object containing the target URL.
href	string , required
status	object , optional	A hyperlink object containing the target URL.
href	string , required
scaOAuth	object , optional	A hyperlink object containing the target URL.
href	string , required
scaStatus	object , optional	A hyperlink object containing the target URL.
href	string , required
scaRedirect	object , optional	A hyperlink object containing the target URL.
href	string , required
confirmation	object , optional	A hyperlink object containing the target URL.
href	string , required
startAuthorisation	object , optional	A hyperlink object containing the target URL.
href	string , required
encryptionCertificates	array[object] , optional	A hyperlink object containing the target URL.
href	string , required
startAuthorisationWithPsuAuthentication	object , optional	A hyperlink object containing the target URL.
href	string , required
startAuthorisationWithPsuIdentification	object , optional	A hyperlink object containing the target URL.
href	string , required
startAuthorisationWithTransactionAuthorisation	object , optional	A hyperlink object containing the target URL.
href	string , required
startAuthorisationWithEncryptedPsuAuthentication	object , optional	A hyperlink object containing the target URL.
href	string , required
startAuthorisationWithAuthenticationMethodSelection	object , optional	A hyperlink object containing the target URL.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined for PIS for HTTP Error code 400 (BAD_REQUEST). Allowed values: FORMAT_ERROR, PARAMETER_NOT_CONSISTENT, PARAMETER_NOT_SUPPORTED, SERVICE_INVALID, CONSENT_UNKNOWN, RESOURCE_UNKNOWN, RESOURCE_EXPIRED, RESOURCE_BLOCKED, TIMESTAMP_INVALID, PERIOD_INVALID, SCA_METHOD_UNKNOWN, SCA_INVALID, PAYMENT_FAILED, EXECUTION_DATE_INVALID Example: `FORMAT_ERROR`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	The link to the payment initiation resource created by the request itself. This link can be used later to retrieve the transaction status of the payment initiation.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
orders	object , optional	A link to the resource providing the list of orders of one securitiesAccount.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
download	object , optional	Download link for huge AIS data packages.
href	string , required
previous	object , optional	Navigation link for paginated account reports.
href	string , required
scaOAuth	object , optional	The link refers to a JSON document specifying the OAuth details of the ASPSP's authorisation server. JSON document follows the definition given in [RFC 8414].
href	string , required
ibanCheck	object , optional	A link to the endpoint offering the addressed iban check result.
href	string , required
positions	object , optional	A link to the resource providing the list of positions of one securitiesAccount.
href	string , required
scaStatus	object , optional	A link to retrieve the status of the authorisation or cancellation-authorisation sub-resource.
href	string , required
cardAccount	object , optional	A link to the resource providing the details of one card account.
href	string , required
loanAccount	object , optional	A link to the resource providing the details of a loan account.
href	string , required
onboardings	object , optional	A link to commercially onboard to the related API, see openFinance, Admin Services for more details.
href	string , required
scaRedirect	object , optional	A link to an ASPSP site where SCA is performed within the Redirect SCA approach.
href	string , required
confirmation	object , optional	"confirmation": Might be added by the ASPSP if either the "scaRedirect" or "scaOAuth" hyperlink is returned in the same response message. This hyperlink defines the URL to the resource which needs to be updated with * a confirmation code as retrieved after the plain redirect authentication process with the ASPSP authentication server or * an access token as retrieved by submitting an authorization code after the integrated Oauth based authentication process with the ASPSP authentication server.
href	string , required
orderDetails	object , optional	A link to the resource providing details of one specific order.
href	string , required
subscription	object , optional	A link to the resource providing the details of a subscription for Push AIS Services.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required
aspspContacts	object , optional	A hyperlink object containing the target URL.
href	string , required
relatedOrders	array[object] , optional	An array of links to request order details of related orders related to the order that is represented by the data structure containing this element (e.g. other orders that originated from the same order split as this order).
href	string , required
aspspDowntimes	object , optional	A hyperlink object containing the target URL.
href	string , required
readConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
savingsAccount	object , optional	A link to the resource providing the details of a savings account.
href	string , required
aspspParameters	object , optional	A hyperlink object containing the target URL.
href	string , required
transactionfees	object , optional	The link is to the status resource. This link is only added within the authorisation process in case fee information is available via the status resource.
href	string , required
cardTransactions	object , optional	A link to the resource providing the transaction history of a dedicated card account.
href	string , required
confirmConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
confirmInitiation	object , optional	link to a confirmation endpoint, where a payment initiation needs to be confirmed explicitly by the API Client for execution.
href	string , required
paymentInitiation	object , optional	A link to an initiation related to a payment resource.
href	string , required
securitiesAccount	object , optional	A link to the resource providing the details of one securitiesAccount.
href	string , required
entryStatusRevoked	array[object] , optional	Links to entry endpoints where the entry status is revoked.
href	string , required
startAuthorisation	object , optional	A link to an endpoint, where the authorisation of a transaction or the authorisation of a transaction cancellation shall be started with a POST command. No specific data is needed for this process start.
href	string , required
transactionDetails	object , optional	A link to the resource providing details of a dedicated transaction.
href	string , required
relatedTransactions	array[object] , optional	An array of links to request securities transaction details of transactions that resulted from this order.
href	string , required
authoriseTransaction	object , optional	The link to the payment initiation or consent resource, where the "Transaction Authorisation"Request" is sent to. This 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.
href	string , required
updateProprietaryData	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the proprietary data.
href	string , required
updatePsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet.
href	string , required
updatePsuIdentification	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the PSU identification if not delivered yet.
href	string , required
selectAuthenticationMethod	object , optional	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.
href	string , required
updateEncryptedPsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by an encrypted PSU password and eventually the PSU identification if not delivered yet.
href	string , required
startAuthorisationWithProprietaryData	object , optional	A link to the endpoint, where the authorisation of a transaction or of a transaction cancellation shall be started, and where proprietary data needs to be updated with this call. The TPP can find the scope of missing proprietary data in the ASPSP documentation. The usage of this hyperlink is not further specified in the specification but is used analogously to e.g. the startAuthorisation withPsuIdentification hyperlink.
href	string , required
updateResourceByDebtorAccountResource	object , optional	A link to a payment related resource which needs to be updated by an account, referenced by a resource identification.
href	string , required
startAuthorisationWithPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithPsuIdentification	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU identification shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithTransactionAuthorisation	object , optional	A link to an endpoint, where an authorisation of a transaction or a cancellation can be started, and where the response data for the challenge is uploaded in the same call for the transaction authorisation or transaction cancellation at the same time in the Embedded SCA Approach.
href	string , required
startAuthorisationWithEncryptedPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where encrypted PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithAuthenticationMethodSelection	object , optional	This is a link to and endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where the selected SCA method shall be uploaded with the corresponding call.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined for PIS for HTTP Error code 401 (UNAUTHORIZED). Allowed values: CERTIFICATE_INVALID, CERTIFICATE_EXPIRED, CERTIFICATE_BLOCKED, CERTIFICATE_REVOKED, CERTIFICATE_MISSING, CLIENT_INVALID, CLIENT_INCONSISTENT, API_CONTRACT_ID_INVALID, SIGNATURE_INVALID, SIGNATURE_MISSING, ROLE_INVALID, PSU_CREDENTIALS_INVALID, CORPORATE_ID_INVALID, CONSENT_INVALID, CONSENT_EXPIRED, TOKEN_UNKNOWN, TOKEN_INVALID, TOKEN_EXPIRED, KID_MISSING Example: `CERTIFICATE_INVALID`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	The link to the payment initiation resource created by the request itself. This link can be used later to retrieve the transaction status of the payment initiation.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
orders	object , optional	A link to the resource providing the list of orders of one securitiesAccount.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
download	object , optional	Download link for huge AIS data packages.
href	string , required
previous	object , optional	Navigation link for paginated account reports.
href	string , required
scaOAuth	object , optional	The link refers to a JSON document specifying the OAuth details of the ASPSP's authorisation server. JSON document follows the definition given in [RFC 8414].
href	string , required
ibanCheck	object , optional	A link to the endpoint offering the addressed iban check result.
href	string , required
positions	object , optional	A link to the resource providing the list of positions of one securitiesAccount.
href	string , required
scaStatus	object , optional	A link to retrieve the status of the authorisation or cancellation-authorisation sub-resource.
href	string , required
cardAccount	object , optional	A link to the resource providing the details of one card account.
href	string , required
loanAccount	object , optional	A link to the resource providing the details of a loan account.
href	string , required
onboardings	object , optional	A link to commercially onboard to the related API, see openFinance, Admin Services for more details.
href	string , required
scaRedirect	object , optional	A link to an ASPSP site where SCA is performed within the Redirect SCA approach.
href	string , required
confirmation	object , optional	"confirmation": Might be added by the ASPSP if either the "scaRedirect" or "scaOAuth" hyperlink is returned in the same response message. This hyperlink defines the URL to the resource which needs to be updated with * a confirmation code as retrieved after the plain redirect authentication process with the ASPSP authentication server or * an access token as retrieved by submitting an authorization code after the integrated Oauth based authentication process with the ASPSP authentication server.
href	string , required
orderDetails	object , optional	A link to the resource providing details of one specific order.
href	string , required
subscription	object , optional	A link to the resource providing the details of a subscription for Push AIS Services.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required
aspspContacts	object , optional	A hyperlink object containing the target URL.
href	string , required
relatedOrders	array[object] , optional	An array of links to request order details of related orders related to the order that is represented by the data structure containing this element (e.g. other orders that originated from the same order split as this order).
href	string , required
aspspDowntimes	object , optional	A hyperlink object containing the target URL.
href	string , required
readConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
savingsAccount	object , optional	A link to the resource providing the details of a savings account.
href	string , required
aspspParameters	object , optional	A hyperlink object containing the target URL.
href	string , required
transactionfees	object , optional	The link is to the status resource. This link is only added within the authorisation process in case fee information is available via the status resource.
href	string , required
cardTransactions	object , optional	A link to the resource providing the transaction history of a dedicated card account.
href	string , required
confirmConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
confirmInitiation	object , optional	link to a confirmation endpoint, where a payment initiation needs to be confirmed explicitly by the API Client for execution.
href	string , required
paymentInitiation	object , optional	A link to an initiation related to a payment resource.
href	string , required
securitiesAccount	object , optional	A link to the resource providing the details of one securitiesAccount.
href	string , required
entryStatusRevoked	array[object] , optional	Links to entry endpoints where the entry status is revoked.
href	string , required
startAuthorisation	object , optional	A link to an endpoint, where the authorisation of a transaction or the authorisation of a transaction cancellation shall be started with a POST command. No specific data is needed for this process start.
href	string , required
transactionDetails	object , optional	A link to the resource providing details of a dedicated transaction.
href	string , required
relatedTransactions	array[object] , optional	An array of links to request securities transaction details of transactions that resulted from this order.
href	string , required
authoriseTransaction	object , optional	The link to the payment initiation or consent resource, where the "Transaction Authorisation"Request" is sent to. This 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.
href	string , required
updateProprietaryData	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the proprietary data.
href	string , required
updatePsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet.
href	string , required
updatePsuIdentification	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the PSU identification if not delivered yet.
href	string , required
selectAuthenticationMethod	object , optional	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.
href	string , required
updateEncryptedPsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by an encrypted PSU password and eventually the PSU identification if not delivered yet.
href	string , required
startAuthorisationWithProprietaryData	object , optional	A link to the endpoint, where the authorisation of a transaction or of a transaction cancellation shall be started, and where proprietary data needs to be updated with this call. The TPP can find the scope of missing proprietary data in the ASPSP documentation. The usage of this hyperlink is not further specified in the specification but is used analogously to e.g. the startAuthorisation withPsuIdentification hyperlink.
href	string , required
updateResourceByDebtorAccountResource	object , optional	A link to a payment related resource which needs to be updated by an account, referenced by a resource identification.
href	string , required
startAuthorisationWithPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithPsuIdentification	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU identification shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithTransactionAuthorisation	object , optional	A link to an endpoint, where an authorisation of a transaction or a cancellation can be started, and where the response data for the challenge is uploaded in the same call for the transaction authorisation or transaction cancellation at the same time in the Embedded SCA Approach.
href	string , required
startAuthorisationWithEncryptedPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where encrypted PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithAuthenticationMethodSelection	object , optional	This is a link to and endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where the selected SCA method shall be uploaded with the corresponding call.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined defined for PIS for PIS for HTTP Error code 403 (FORBIDDEN). Allowed values: SERVICE_BLOCKED, CONSENT_UNKNOWN, RESOURCE_UNKNOWN, RESOURCE_EXPIRED, PRODUCT_INVALID Example: `SERVICE_BLOCKED`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	The link to the payment initiation resource created by the request itself. This link can be used later to retrieve the transaction status of the payment initiation.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
orders	object , optional	A link to the resource providing the list of orders of one securitiesAccount.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
download	object , optional	Download link for huge AIS data packages.
href	string , required
previous	object , optional	Navigation link for paginated account reports.
href	string , required
scaOAuth	object , optional	The link refers to a JSON document specifying the OAuth details of the ASPSP's authorisation server. JSON document follows the definition given in [RFC 8414].
href	string , required
ibanCheck	object , optional	A link to the endpoint offering the addressed iban check result.
href	string , required
positions	object , optional	A link to the resource providing the list of positions of one securitiesAccount.
href	string , required
scaStatus	object , optional	A link to retrieve the status of the authorisation or cancellation-authorisation sub-resource.
href	string , required
cardAccount	object , optional	A link to the resource providing the details of one card account.
href	string , required
loanAccount	object , optional	A link to the resource providing the details of a loan account.
href	string , required
onboardings	object , optional	A link to commercially onboard to the related API, see openFinance, Admin Services for more details.
href	string , required
scaRedirect	object , optional	A link to an ASPSP site where SCA is performed within the Redirect SCA approach.
href	string , required
confirmation	object , optional	"confirmation": Might be added by the ASPSP if either the "scaRedirect" or "scaOAuth" hyperlink is returned in the same response message. This hyperlink defines the URL to the resource which needs to be updated with * a confirmation code as retrieved after the plain redirect authentication process with the ASPSP authentication server or * an access token as retrieved by submitting an authorization code after the integrated Oauth based authentication process with the ASPSP authentication server.
href	string , required
orderDetails	object , optional	A link to the resource providing details of one specific order.
href	string , required
subscription	object , optional	A link to the resource providing the details of a subscription for Push AIS Services.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required
aspspContacts	object , optional	A hyperlink object containing the target URL.
href	string , required
relatedOrders	array[object] , optional	An array of links to request order details of related orders related to the order that is represented by the data structure containing this element (e.g. other orders that originated from the same order split as this order).
href	string , required
aspspDowntimes	object , optional	A hyperlink object containing the target URL.
href	string , required
readConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
savingsAccount	object , optional	A link to the resource providing the details of a savings account.
href	string , required
aspspParameters	object , optional	A hyperlink object containing the target URL.
href	string , required
transactionfees	object , optional	The link is to the status resource. This link is only added within the authorisation process in case fee information is available via the status resource.
href	string , required
cardTransactions	object , optional	A link to the resource providing the transaction history of a dedicated card account.
href	string , required
confirmConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
confirmInitiation	object , optional	link to a confirmation endpoint, where a payment initiation needs to be confirmed explicitly by the API Client for execution.
href	string , required
paymentInitiation	object , optional	A link to an initiation related to a payment resource.
href	string , required
securitiesAccount	object , optional	A link to the resource providing the details of one securitiesAccount.
href	string , required
entryStatusRevoked	array[object] , optional	Links to entry endpoints where the entry status is revoked.
href	string , required
startAuthorisation	object , optional	A link to an endpoint, where the authorisation of a transaction or the authorisation of a transaction cancellation shall be started with a POST command. No specific data is needed for this process start.
href	string , required
transactionDetails	object , optional	A link to the resource providing details of a dedicated transaction.
href	string , required
relatedTransactions	array[object] , optional	An array of links to request securities transaction details of transactions that resulted from this order.
href	string , required
authoriseTransaction	object , optional	The link to the payment initiation or consent resource, where the "Transaction Authorisation"Request" is sent to. This 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.
href	string , required
updateProprietaryData	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the proprietary data.
href	string , required
updatePsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet.
href	string , required
updatePsuIdentification	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the PSU identification if not delivered yet.
href	string , required
selectAuthenticationMethod	object , optional	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.
href	string , required
updateEncryptedPsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by an encrypted PSU password and eventually the PSU identification if not delivered yet.
href	string , required
startAuthorisationWithProprietaryData	object , optional	A link to the endpoint, where the authorisation of a transaction or of a transaction cancellation shall be started, and where proprietary data needs to be updated with this call. The TPP can find the scope of missing proprietary data in the ASPSP documentation. The usage of this hyperlink is not further specified in the specification but is used analogously to e.g. the startAuthorisation withPsuIdentification hyperlink.
href	string , required
updateResourceByDebtorAccountResource	object , optional	A link to a payment related resource which needs to be updated by an account, referenced by a resource identification.
href	string , required
startAuthorisationWithPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithPsuIdentification	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU identification shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithTransactionAuthorisation	object , optional	A link to an endpoint, where an authorisation of a transaction or a cancellation can be started, and where the response data for the challenge is uploaded in the same call for the transaction authorisation or transaction cancellation at the same time in the Embedded SCA Approach.
href	string , required
startAuthorisationWithEncryptedPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where encrypted PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithAuthenticationMethodSelection	object , optional	This is a link to and endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where the selected SCA method shall be uploaded with the corresponding call.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined for payment cancelations within PIS for HTTP Error code 405 (METHOD NOT ALLOWED) Allowed values: SERVICE_INVALID, CANCELLATION_INVALID Example: `SERVICE_INVALID`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	The link to the payment initiation resource created by the request itself. This link can be used later to retrieve the transaction status of the payment initiation.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
orders	object , optional	A link to the resource providing the list of orders of one securitiesAccount.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
download	object , optional	Download link for huge AIS data packages.
href	string , required
previous	object , optional	Navigation link for paginated account reports.
href	string , required
scaOAuth	object , optional	The link refers to a JSON document specifying the OAuth details of the ASPSP's authorisation server. JSON document follows the definition given in [RFC 8414].
href	string , required
ibanCheck	object , optional	A link to the endpoint offering the addressed iban check result.
href	string , required
positions	object , optional	A link to the resource providing the list of positions of one securitiesAccount.
href	string , required
scaStatus	object , optional	A link to retrieve the status of the authorisation or cancellation-authorisation sub-resource.
href	string , required
cardAccount	object , optional	A link to the resource providing the details of one card account.
href	string , required
loanAccount	object , optional	A link to the resource providing the details of a loan account.
href	string , required
onboardings	object , optional	A link to commercially onboard to the related API, see openFinance, Admin Services for more details.
href	string , required
scaRedirect	object , optional	A link to an ASPSP site where SCA is performed within the Redirect SCA approach.
href	string , required
confirmation	object , optional	"confirmation": Might be added by the ASPSP if either the "scaRedirect" or "scaOAuth" hyperlink is returned in the same response message. This hyperlink defines the URL to the resource which needs to be updated with * a confirmation code as retrieved after the plain redirect authentication process with the ASPSP authentication server or * an access token as retrieved by submitting an authorization code after the integrated Oauth based authentication process with the ASPSP authentication server.
href	string , required
orderDetails	object , optional	A link to the resource providing details of one specific order.
href	string , required
subscription	object , optional	A link to the resource providing the details of a subscription for Push AIS Services.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required
aspspContacts	object , optional	A hyperlink object containing the target URL.
href	string , required
relatedOrders	array[object] , optional	An array of links to request order details of related orders related to the order that is represented by the data structure containing this element (e.g. other orders that originated from the same order split as this order).
href	string , required
aspspDowntimes	object , optional	A hyperlink object containing the target URL.
href	string , required
readConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
savingsAccount	object , optional	A link to the resource providing the details of a savings account.
href	string , required
aspspParameters	object , optional	A hyperlink object containing the target URL.
href	string , required
transactionfees	object , optional	The link is to the status resource. This link is only added within the authorisation process in case fee information is available via the status resource.
href	string , required
cardTransactions	object , optional	A link to the resource providing the transaction history of a dedicated card account.
href	string , required
confirmConditions	object , optional	A hyperlink object containing the target URL.
href	string , required
confirmInitiation	object , optional	link to a confirmation endpoint, where a payment initiation needs to be confirmed explicitly by the API Client for execution.
href	string , required
paymentInitiation	object , optional	A link to an initiation related to a payment resource.
href	string , required
securitiesAccount	object , optional	A link to the resource providing the details of one securitiesAccount.
href	string , required
entryStatusRevoked	array[object] , optional	Links to entry endpoints where the entry status is revoked.
href	string , required
startAuthorisation	object , optional	A link to an endpoint, where the authorisation of a transaction or the authorisation of a transaction cancellation shall be started with a POST command. No specific data is needed for this process start.
href	string , required
transactionDetails	object , optional	A link to the resource providing details of a dedicated transaction.
href	string , required
relatedTransactions	array[object] , optional	An array of links to request securities transaction details of transactions that resulted from this order.
href	string , required
authoriseTransaction	object , optional	The link to the payment initiation or consent resource, where the "Transaction Authorisation"Request" is sent to. This 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.
href	string , required
updateProprietaryData	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the proprietary data.
href	string , required
updatePsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by a PSU password and eventually the PSU identification if not delivered yet.
href	string , required
updatePsuIdentification	object , optional	The link to the payment initiation or account information resource, which needs to be updated by the PSU identification if not delivered yet.
href	string , required
selectAuthenticationMethod	object , optional	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.
href	string , required
updateEncryptedPsuAuthentication	object , optional	The link to the payment initiation or account information resource, which needs to be updated by an encrypted PSU password and eventually the PSU identification if not delivered yet.
href	string , required
startAuthorisationWithProprietaryData	object , optional	A link to the endpoint, where the authorisation of a transaction or of a transaction cancellation shall be started, and where proprietary data needs to be updated with this call. The TPP can find the scope of missing proprietary data in the ASPSP documentation. The usage of this hyperlink is not further specified in the specification but is used analogously to e.g. the startAuthorisation withPsuIdentification hyperlink.
href	string , required
updateResourceByDebtorAccountResource	object , optional	A link to a payment related resource which needs to be updated by an account, referenced by a resource identification.
href	string , required
startAuthorisationWithPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithPsuIdentification	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where PSU identification shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithTransactionAuthorisation	object , optional	A link to an endpoint, where an authorisation of a transaction or a cancellation can be started, and where the response data for the challenge is uploaded in the same call for the transaction authorisation or transaction cancellation at the same time in the Embedded SCA Approach.
href	string , required
startAuthorisationWithEncryptedPsuAuthentication	object , optional	The link to an endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where encrypted PSU authentication data shall be uploaded with the corresponding call.
href	string , required
startAuthorisationWithAuthenticationMethodSelection	object , optional	This is a link to and endpoint where the authorisation of a transaction or of a transaction cancellation shall be started, where the selected SCA method shall be uploaded with the corresponding call.
href	string , required

curl -X DELETE \
  "https://openfinance.saltedge.com/ria_money_transfer_sandbox/api/v2/{payment-service}/{payment-product}/{paymentId}" \
  -H "X-Request-ID: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721"

{
  "transactionStatus": "ACCC",
  "_links": {
    "self": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "scaOAuth": {
      "href": "string"
    },
    "scaStatus": {
      "href": "string"
    },
    "scaRedirect": {
      "href": "string"
    },
    "confirmation": {
      "href": "string"
    },
    "startAuthorisation": {
      "href": "string"
    },
    "encryptionCertificates": [
      {
        "href": "string"
      }
    ],
    "startAuthorisationWithPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithPsuIdentification": {
      "href": "string"
    },
    "startAuthorisationWithTransactionAuthorisation": {
      "href": "string"
    },
    "startAuthorisationWithEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithAuthenticationMethodSelection": {
      "href": "string"
    }
  }
}

No response body.

{
  "apiClientMessages": [
    {
      "code": "FORMAT_ERROR",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "orders": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "download": {
      "href": "string"
    },
    "previous": {
      "href": "string"
    },
    "scaOAuth": {
      "href": "string"
    },
    "ibanCheck": {
      "href": "string"
    },
    "positions": {
      "href": "string"
    },
    "scaStatus": {
      "href": "string"
    },
    "cardAccount": {
      "href": "string"
    },
    "loanAccount": {
      "href": "string"
    },
    "onboardings": {
      "href": "string"
    },
    "scaRedirect": {
      "href": "string"
    },
    "confirmation": {
      "href": "string"
    },
    "orderDetails": {
      "href": "string"
    },
    "subscription": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    },
    "aspspContacts": {
      "href": "string"
    },
    "relatedOrders": [
      {
        "href": "string"
      }
    ],
    "aspspDowntimes": {
      "href": "string"
    },
    "readConditions": {
      "href": "string"
    },
    "savingsAccount": {
      "href": "string"
    },
    "aspspParameters": {
      "href": "string"
    },
    "transactionfees": {
      "href": "string"
    },
    "cardTransactions": {
      "href": "string"
    },
    "confirmConditions": {
      "href": "string"
    },
    "confirmInitiation": {
      "href": "string"
    },
    "paymentInitiation": {
      "href": "string"
    },
    "securitiesAccount": {
      "href": "string"
    },
    "entryStatusRevoked": [
      {
        "href": "string"
      }
    ],
    "startAuthorisation": {
      "href": "string"
    },
    "transactionDetails": {
      "href": "string"
    },
    "relatedTransactions": [
      {
        "href": "string"
      }
    ],
    "authoriseTransaction": {
      "href": "string"
    },
    "updateProprietaryData": {
      "href": "string"
    },
    "updatePsuAuthentication": {
      "href": "string"
    },
    "updatePsuIdentification": {
      "href": "string"
    },
    "selectAuthenticationMethod": {
      "href": "string"
    },
    "updateEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithProprietaryData": {
      "href": "string"
    },
    "updateResourceByDebtorAccountResource": {
      "href": "string"
    },
    "startAuthorisationWithPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithPsuIdentification": {
      "href": "string"
    },
    "startAuthorisationWithTransactionAuthorisation": {
      "href": "string"
    },
    "startAuthorisationWithEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithAuthenticationMethodSelection": {
      "href": "string"
    }
  }
}

{
  "apiClientMessages": [
    {
      "code": "CERTIFICATE_INVALID",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "orders": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "download": {
      "href": "string"
    },
    "previous": {
      "href": "string"
    },
    "scaOAuth": {
      "href": "string"
    },
    "ibanCheck": {
      "href": "string"
    },
    "positions": {
      "href": "string"
    },
    "scaStatus": {
      "href": "string"
    },
    "cardAccount": {
      "href": "string"
    },
    "loanAccount": {
      "href": "string"
    },
    "onboardings": {
      "href": "string"
    },
    "scaRedirect": {
      "href": "string"
    },
    "confirmation": {
      "href": "string"
    },
    "orderDetails": {
      "href": "string"
    },
    "subscription": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    },
    "aspspContacts": {
      "href": "string"
    },
    "relatedOrders": [
      {
        "href": "string"
      }
    ],
    "aspspDowntimes": {
      "href": "string"
    },
    "readConditions": {
      "href": "string"
    },
    "savingsAccount": {
      "href": "string"
    },
    "aspspParameters": {
      "href": "string"
    },
    "transactionfees": {
      "href": "string"
    },
    "cardTransactions": {
      "href": "string"
    },
    "confirmConditions": {
      "href": "string"
    },
    "confirmInitiation": {
      "href": "string"
    },
    "paymentInitiation": {
      "href": "string"
    },
    "securitiesAccount": {
      "href": "string"
    },
    "entryStatusRevoked": [
      {
        "href": "string"
      }
    ],
    "startAuthorisation": {
      "href": "string"
    },
    "transactionDetails": {
      "href": "string"
    },
    "relatedTransactions": [
      {
        "href": "string"
      }
    ],
    "authoriseTransaction": {
      "href": "string"
    },
    "updateProprietaryData": {
      "href": "string"
    },
    "updatePsuAuthentication": {
      "href": "string"
    },
    "updatePsuIdentification": {
      "href": "string"
    },
    "selectAuthenticationMethod": {
      "href": "string"
    },
    "updateEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithProprietaryData": {
      "href": "string"
    },
    "updateResourceByDebtorAccountResource": {
      "href": "string"
    },
    "startAuthorisationWithPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithPsuIdentification": {
      "href": "string"
    },
    "startAuthorisationWithTransactionAuthorisation": {
      "href": "string"
    },
    "startAuthorisationWithEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithAuthenticationMethodSelection": {
      "href": "string"
    }
  }
}

{
  "apiClientMessages": [
    {
      "code": "SERVICE_BLOCKED",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "orders": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "download": {
      "href": "string"
    },
    "previous": {
      "href": "string"
    },
    "scaOAuth": {
      "href": "string"
    },
    "ibanCheck": {
      "href": "string"
    },
    "positions": {
      "href": "string"
    },
    "scaStatus": {
      "href": "string"
    },
    "cardAccount": {
      "href": "string"
    },
    "loanAccount": {
      "href": "string"
    },
    "onboardings": {
      "href": "string"
    },
    "scaRedirect": {
      "href": "string"
    },
    "confirmation": {
      "href": "string"
    },
    "orderDetails": {
      "href": "string"
    },
    "subscription": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    },
    "aspspContacts": {
      "href": "string"
    },
    "relatedOrders": [
      {
        "href": "string"
      }
    ],
    "aspspDowntimes": {
      "href": "string"
    },
    "readConditions": {
      "href": "string"
    },
    "savingsAccount": {
      "href": "string"
    },
    "aspspParameters": {
      "href": "string"
    },
    "transactionfees": {
      "href": "string"
    },
    "cardTransactions": {
      "href": "string"
    },
    "confirmConditions": {
      "href": "string"
    },
    "confirmInitiation": {
      "href": "string"
    },
    "paymentInitiation": {
      "href": "string"
    },
    "securitiesAccount": {
      "href": "string"
    },
    "entryStatusRevoked": [
      {
        "href": "string"
      }
    ],
    "startAuthorisation": {
      "href": "string"
    },
    "transactionDetails": {
      "href": "string"
    },
    "relatedTransactions": [
      {
        "href": "string"
      }
    ],
    "authoriseTransaction": {
      "href": "string"
    },
    "updateProprietaryData": {
      "href": "string"
    },
    "updatePsuAuthentication": {
      "href": "string"
    },
    "updatePsuIdentification": {
      "href": "string"
    },
    "selectAuthenticationMethod": {
      "href": "string"
    },
    "updateEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithProprietaryData": {
      "href": "string"
    },
    "updateResourceByDebtorAccountResource": {
      "href": "string"
    },
    "startAuthorisationWithPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithPsuIdentification": {
      "href": "string"
    },
    "startAuthorisationWithTransactionAuthorisation": {
      "href": "string"
    },
    "startAuthorisationWithEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithAuthenticationMethodSelection": {
      "href": "string"
    }
  }
}

{
  "apiClientMessages": [
    {
      "code": "SERVICE_INVALID",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "orders": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "download": {
      "href": "string"
    },
    "previous": {
      "href": "string"
    },
    "scaOAuth": {
      "href": "string"
    },
    "ibanCheck": {
      "href": "string"
    },
    "positions": {
      "href": "string"
    },
    "scaStatus": {
      "href": "string"
    },
    "cardAccount": {
      "href": "string"
    },
    "loanAccount": {
      "href": "string"
    },
    "onboardings": {
      "href": "string"
    },
    "scaRedirect": {
      "href": "string"
    },
    "confirmation": {
      "href": "string"
    },
    "orderDetails": {
      "href": "string"
    },
    "subscription": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    },
    "aspspContacts": {
      "href": "string"
    },
    "relatedOrders": [
      {
        "href": "string"
      }
    ],
    "aspspDowntimes": {
      "href": "string"
    },
    "readConditions": {
      "href": "string"
    },
    "savingsAccount": {
      "href": "string"
    },
    "aspspParameters": {
      "href": "string"
    },
    "transactionfees": {
      "href": "string"
    },
    "cardTransactions": {
      "href": "string"
    },
    "confirmConditions": {
      "href": "string"
    },
    "confirmInitiation": {
      "href": "string"
    },
    "paymentInitiation": {
      "href": "string"
    },
    "securitiesAccount": {
      "href": "string"
    },
    "entryStatusRevoked": [
      {
        "href": "string"
      }
    ],
    "startAuthorisation": {
      "href": "string"
    },
    "transactionDetails": {
      "href": "string"
    },
    "relatedTransactions": [
      {
        "href": "string"
      }
    ],
    "authoriseTransaction": {
      "href": "string"
    },
    "updateProprietaryData": {
      "href": "string"
    },
    "updatePsuAuthentication": {
      "href": "string"
    },
    "updatePsuIdentification": {
      "href": "string"
    },
    "selectAuthenticationMethod": {
      "href": "string"
    },
    "updateEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithProprietaryData": {
      "href": "string"
    },
    "updateResourceByDebtorAccountResource": {
      "href": "string"
    },
    "startAuthorisationWithPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithPsuIdentification": {
      "href": "string"
    },
    "startAuthorisationWithTransactionAuthorisation": {
      "href": "string"
    },
    "startAuthorisationWithEncryptedPsuAuthentication": {
      "href": "string"
    },
    "startAuthorisationWithAuthenticationMethodSelection": {
      "href": "string"
    }
  }
}