Typical use case

You created a Payment Request; a transaction has been initiated from it and authorised, thus the initiatingPartyReturnURL (with the placeholder "{transactionToken}" appropriately replaced with the "transaction token" uniquely identifying the MyBank Transaction) has been requested; so, you want to retrieve the final status of the transaction.
Please note that this API should only be invoked once for each Transaction, when the initiatingPartyReturnURL is requested.

Request body attributes

All attributes in the request body are mandatory.

Typical use of the response

You will check transactionStatus to know whether the Transaction has been authorised by the Payer.
Depending on the integration with the Payee, you will somehow transmit the result of the Transaction to the Payee.
It is particularly important to correctly handle the response of this API: as explained in the "Technical Overview", an HTTP status code other than 200, as well as a result other than 200 do NOT give any indication on the actual status of the MyBank Transaction: in such circumstances, the Payee PSP must retry and invoke transactionDetails at a later time. Only if the response comes with an HTTP status code 200 and a result 200 can the status of the Transaction be assessed.