Read the SCA status of the payment authorisation

get https://test-openbanking.tbcbank.ge/0.8/v1/{payment-service}/{payment-product}/{paymentId}/authorisations/{authorisationId}

This method returns the SCA status of a payment initiation's authorisation sub-resource.

Path Params

payment-service

string

required

Payment service:

Possible values are:

payments
bulk-payments (not implemented yet)
periodic-payments (not implemented yet)

payment-product

string

required

The following payment products are supported:

aspsp
domestic
foreign

paymentId

string

required

Resource identification of the generated payment initiation resource.

authorisationId

string

required

Resource identification of the related SCA.

Headers

X-Request-ID

uuid

required

ID of the request, unique to the call, as determined by the initiating party.

Digest

string

Is contained if and only if the "Signature" element is contained in the header of the request.

Signature

string

A signature of the request by the TPP on application level. This might be mandated by ASPSP.

TPP-Signature-Certificate

string

The certificate used for signing the request, in base64 encoding.
Must be contained if a signature is contained.

PSU-IP-Address

string

The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP.

PSU-IP-Port

string

The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.

PSU-Accept

string

The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.

PSU-Accept-Charset

string

The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.

PSU-Accept-Encoding

string

The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.

PSU-Accept-Language

string

The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.

PSU-User-Agent

string

The forwarded Agent header field of the HTTP request between PSU and TPP, if available.

PSU-Http-Method

string

HTTP method used at the PSU ? TPP interface, if available.
Valid values are:

GET
POST
PUT
PATCH
DELETE

PSU-Device-ID

uuid

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.

PSU-Geo-Location

string

The forwarded Geo Location of the corresponding http request between PSU and TPP if available.

Responses

Response body

object

scaStatus

string

required

This data element is containing information about the status of the SCA method applied.

The following codes are defined for this data type.

'received':
An authorisation or cancellation-authorisation resource has been created successfully.
'psuIdentified':
The PSU related to the authorisation or cancellation-authorisation resource has been identified.
'psuAuthenticated':
The PSU related to the authorisation or cancellation-authorisation resource has been identified and authenticated e.g. by a password or by an access token.
'scaMethodSelected':
The PSU/TPP has selected the related SCA routine.
If the SCA method is chosen implicitly since only one SCA method is available,
then this is the first status to be reported instead of 'received'.
'unconfirmed':
SCA is technically successfully finalised by the PSU, but the authorisation resource needs a confirmation command by the TPP yet.
'started':
The addressed SCA routine has been started.
'finalised':
The SCA routine has been finalised successfully (including a potential confirmation command).
This is a final status of the authorisation resource.
'failed':
The SCA routine failed.
This is a final status of the authorisation resource.
'exempted':
SCA was exempted for the related transaction, the related authorisation is successful.
This is a final status of the authorisation resource.

received psuIdentified psuAuthenticated scaMethodSelected started unconfirmed finalised failed exempted

psuMessage

string

length ≤ 500

Text to be displayed to the PSU.

trustedBeneficiaryFlag

boolean

Additional Service: Trusted Benificiaries
Within this data element, the ASPSP might optionally communicate towards the TPP whether the creditor was part of the related trusted beneficiary list.
This attribute is only contained in case of a final scaStatus.

_links

object

A _link object with all available link types.

scaRedirect

object

Link to a resource.

scaOAuth

object

Link to a resource.

confirmation

object

Link to a resource.

startAuthorisation

object

Link to a resource.

startAuthorisationWithPsuIdentification

object

Link to a resource.

updatePsuIdentification

object

Link to a resource.

startAuthorisationWithProprietaryData

object

Link to a resource.

updateProprietaryData

object

Link to a resource.

startAuthorisationWithPsuAuthentication

object

Link to a resource.

updatePsuAuthentication

object

Link to a resource.

startAuthorisationWithEncryptedPsuAuthentication

object

Link to a resource.

updateEncryptedPsuAuthentication

object

Link to a resource.

updateAdditionalPsuAuthentication

object

Link to a resource.

updateAdditionalEncryptedPsuAuthentication

object

Link to a resource.

startAuthorisationWithAuthenticationMethodSelection

object

Link to a resource.

selectAuthenticationMethod

object

Link to a resource.

startAuthorisationWithTransactionAuthorisation

object

Link to a resource.

authoriseTransaction

object

Link to a resource.

self

object

Link to a resource.

status

object

Link to a resource.

scaStatus

object

Link to a resource.

account

object

Link to a resource.

balances

object

Link to a resource.

transactions

object

Link to a resource.

transactionDetails

object

Link to a resource.

cardAccount

object

Link to a resource.

cardTransactions

object

Link to a resource.

first

object

Link to a resource.

object

Link to a resource.

object

Link to a resource.

last

object

Link to a resource.

download

object

Link to a resource.

tppMessage

array of objects

Messages to the TPP on operational issues.

tppMessage

object

category

string

required

Category of the TPP message category.

ERROR WARNING

code

string

required

Category of the TPP message category.

ERROR WARNING

path

string

text

string

length ≤ 500

Additional explaining text to the TPP.

Headers

object

X-Request-ID

uuid

ID of the request, unique to the call, as determined by the initiating party.

Response body

object

tppMessages

array of objects

tppMessages

object

category

string

required

Category of the TPP message category.

ERROR WARNING

code

string

required

Message codes defined for PIS for HTTP Error code 400 (BAD_REQUEST).

FORMAT_ERROR PARAMETER_NOT_CONSISTENT PARAMETER_NOT_SUPPORTED SERVICE_INVALID RESOURCE_UNKNOWN RESOURCE_EXPIRED RESOURCE_BLOCKED TIMESTAMP_INVALID PERIOD_INVALID SCA_METHOD_UNKNOWN SCA_INVALID CONSENT_UNKNOWN PAYMENT_FAILED EXECUTION_DATE_INVALID

path

string

text

string

length ≤ 500

Additional explaining text to the TPP.

_links

object

A _link object with all available link types.

scaRedirect

object

Link to a resource.

scaOAuth

object

Link to a resource.

confirmation

object

Link to a resource.

startAuthorisation

object

Link to a resource.

startAuthorisationWithPsuIdentification

object

Link to a resource.

updatePsuIdentification

object

Link to a resource.

startAuthorisationWithProprietaryData

object

Link to a resource.

updateProprietaryData

object

Link to a resource.

startAuthorisationWithPsuAuthentication

object

Link to a resource.

updatePsuAuthentication

object

Link to a resource.

startAuthorisationWithEncryptedPsuAuthentication

object

Link to a resource.

updateEncryptedPsuAuthentication

object

Link to a resource.

updateAdditionalPsuAuthentication

object

Link to a resource.

updateAdditionalEncryptedPsuAuthentication

object

Link to a resource.

startAuthorisationWithAuthenticationMethodSelection

object

Link to a resource.

selectAuthenticationMethod

object

Link to a resource.

startAuthorisationWithTransactionAuthorisation

object

Link to a resource.

authoriseTransaction

object

Link to a resource.

self

object

Link to a resource.

status

object

Link to a resource.

scaStatus

object

Link to a resource.

account

object

Link to a resource.

balances

object

Link to a resource.

transactions

object

Link to a resource.

transactionDetails

object

Link to a resource.

cardAccount

object

Link to a resource.

cardTransactions

object

Link to a resource.

first

object

Link to a resource.

object

Link to a resource.

object

Link to a resource.

last

object

Link to a resource.

download

object

Link to a resource.

Headers

object

Location

url

Location of the created resource.

X-Request-ID

uuid

ID of the request, unique to the call, as determined by the initiating party.

Response body

object

tppMessages

array of objects

tppMessages

object

category

string

required

Category of the TPP message category.

ERROR WARNING

code

string

required

Message codes defined for PIS for HTTP Error code 401 (UNAUTHORIZED).

CERTIFICATE_INVALID ROLE_INVALID CERTIFICATE_EXPIRED CERTIFICATE_BLOCKED CERTIFICATE_REVOKE CERTIFICATE_MISSING SIGNATURE_INVALID SIGNATURE_MISSING CORPORATE_ID_INVALID PSU_CREDENTIALS_INVALID CONSENT_INVALID CONSENT_EXPIRED TOKEN_UNKNOWN TOKEN_INVALID TOKEN_EXPIRED REQUIRED_KID_MISSING

path

string

text

string

length ≤ 500

Additional explaining text to the TPP.

_links

object

A _link object with all available link types.

scaRedirect

object

Link to a resource.

scaOAuth

object

Link to a resource.

confirmation

object

Link to a resource.

startAuthorisation

object

Link to a resource.

startAuthorisationWithPsuIdentification

object

Link to a resource.

updatePsuIdentification

object

Link to a resource.

startAuthorisationWithProprietaryData

object

Link to a resource.

updateProprietaryData

object

Link to a resource.

startAuthorisationWithPsuAuthentication

object

Link to a resource.

updatePsuAuthentication

object

Link to a resource.

startAuthorisationWithEncryptedPsuAuthentication

object

Link to a resource.

updateEncryptedPsuAuthentication

object

Link to a resource.

updateAdditionalPsuAuthentication

object

Link to a resource.

updateAdditionalEncryptedPsuAuthentication

object

Link to a resource.

startAuthorisationWithAuthenticationMethodSelection

object

Link to a resource.

selectAuthenticationMethod

object

Link to a resource.

startAuthorisationWithTransactionAuthorisation

object

Link to a resource.

authoriseTransaction

object

Link to a resource.

self

object

Link to a resource.

status

object

Link to a resource.

scaStatus

object

Link to a resource.

account

object

Link to a resource.

balances

object

Link to a resource.

transactions

object

Link to a resource.

transactionDetails

object

Link to a resource.

cardAccount

object

Link to a resource.

cardTransactions

object

Link to a resource.

first

object

Link to a resource.

object

Link to a resource.

object

Link to a resource.

last

object

Link to a resource.

download

object

Link to a resource.

Headers

object

Location

url

Location of the created resource.

X-Request-ID

uuid

ID of the request, unique to the call, as determined by the initiating party.

Response body

object

tppMessages

array of objects

tppMessages

object

category

string

required

Category of the TPP message category.

ERROR WARNING

code

string

required

Message codes defined defined for PIS for PIS for HTTP Error code 403 (FORBIDDEN).

CONSENT_UNKNOWN SERVICE_BLOCKED RESOURCE_UNKNOWN RESOURCE_EXPIRED PRODUCT_INVALID

path

string

text

string

length ≤ 500

Additional explaining text to the TPP.

_links

object

A _link object with all available link types.

scaRedirect

object

Link to a resource.

scaOAuth

object

Link to a resource.

confirmation

object

Link to a resource.

startAuthorisation

object

Link to a resource.

startAuthorisationWithPsuIdentification

object

Link to a resource.

updatePsuIdentification

object

Link to a resource.

startAuthorisationWithProprietaryData

object

Link to a resource.

updateProprietaryData

object

Link to a resource.

startAuthorisationWithPsuAuthentication

object

Link to a resource.

updatePsuAuthentication

object

Link to a resource.

startAuthorisationWithEncryptedPsuAuthentication

object

Link to a resource.

updateEncryptedPsuAuthentication

object

Link to a resource.

updateAdditionalPsuAuthentication

object

Link to a resource.

updateAdditionalEncryptedPsuAuthentication

object

Link to a resource.

startAuthorisationWithAuthenticationMethodSelection

object

Link to a resource.

selectAuthenticationMethod

object

Link to a resource.

startAuthorisationWithTransactionAuthorisation

object

Link to a resource.

authoriseTransaction

object

Link to a resource.

self

object

Link to a resource.

status

object

Link to a resource.

scaStatus

object

Link to a resource.

account

object

Link to a resource.

balances

object

Link to a resource.

transactions

object

Link to a resource.

transactionDetails

object

Link to a resource.

cardAccount

object

Link to a resource.

cardTransactions

object

Link to a resource.

first

object

Link to a resource.

object

Link to a resource.

object

Link to a resource.

last

object

Link to a resource.

download

object

Link to a resource.

Headers

object

Location

url

Location of the created resource.

X-Request-ID

uuid

ID of the request, unique to the call, as determined by the initiating party.

Response body

object

tppMessages

array of objects

tppMessages

object

category

string

required

Category of the TPP message category.

ERROR WARNING

code

string

required

Message codes defined for PIS for HTTP Error code 404 (NOT FOUND).

RESOURCE_UNKNOWN PRODUCT_UNKNOWN

path

string

text

string

length ≤ 500

Additional explaining text to the TPP.

_links

object

A _link object with all available link types.

scaRedirect

object

Link to a resource.

scaOAuth

object

Link to a resource.

confirmation

object

Link to a resource.

startAuthorisation

object

Link to a resource.

startAuthorisationWithPsuIdentification

object

Link to a resource.

updatePsuIdentification

object

Link to a resource.

startAuthorisationWithProprietaryData

object

Link to a resource.

updateProprietaryData

object

Link to a resource.

startAuthorisationWithPsuAuthentication

object

Link to a resource.

updatePsuAuthentication

object

Link to a resource.

startAuthorisationWithEncryptedPsuAuthentication

object

Link to a resource.

updateEncryptedPsuAuthentication

object

Link to a resource.

updateAdditionalPsuAuthentication

object

Link to a resource.

updateAdditionalEncryptedPsuAuthentication

object

Link to a resource.

startAuthorisationWithAuthenticationMethodSelection

object

Link to a resource.

selectAuthenticationMethod

object

Link to a resource.

startAuthorisationWithTransactionAuthorisation

object

Link to a resource.

authoriseTransaction

object

Link to a resource.

self

object

Link to a resource.

status

object

Link to a resource.

scaStatus

object

Link to a resource.

account

object

Link to a resource.

balances

object

Link to a resource.

transactions

object

Link to a resource.

transactionDetails

object

Link to a resource.

cardAccount

object

Link to a resource.

cardTransactions

object

Link to a resource.

first

object

Link to a resource.

object

Link to a resource.

object

Link to a resource.

last

object

Link to a resource.

download

object

Link to a resource.

Headers

object

Location

url

Location of the created resource.

X-Request-ID

uuid

ID of the request, unique to the call, as determined by the initiating party.

Response body

object

tppMessages

array of objects

tppMessages

object

category

string

required

Category of the TPP message category.

ERROR WARNING

code

string

required

Message codes defined for payment cancelations PIS for HTTP Error code 405 (METHOD NOT ALLOWED).

SERVICE_INVALID

path

string

text

string

length ≤ 500

Additional explaining text to the TPP.

_links

object

A _link object with all available link types.

scaRedirect

object

Link to a resource.

scaOAuth

object

Link to a resource.

confirmation

object

Link to a resource.

startAuthorisation

object

Link to a resource.

startAuthorisationWithPsuIdentification

object

Link to a resource.

updatePsuIdentification

object

Link to a resource.

startAuthorisationWithProprietaryData

object

Link to a resource.

updateProprietaryData

object

Link to a resource.

startAuthorisationWithPsuAuthentication

object

Link to a resource.

updatePsuAuthentication

object

Link to a resource.

startAuthorisationWithEncryptedPsuAuthentication

object

Link to a resource.

updateEncryptedPsuAuthentication

object

Link to a resource.

updateAdditionalPsuAuthentication

object

Link to a resource.

updateAdditionalEncryptedPsuAuthentication

object

Link to a resource.

startAuthorisationWithAuthenticationMethodSelection

object

Link to a resource.

selectAuthenticationMethod

object

Link to a resource.

startAuthorisationWithTransactionAuthorisation

object

Link to a resource.

authoriseTransaction

object

Link to a resource.

self

object

Link to a resource.

status

object

Link to a resource.

scaStatus

object

Link to a resource.

account

object

Link to a resource.

balances

object

Link to a resource.

transactions

object

Link to a resource.

transactionDetails

object

Link to a resource.

cardAccount

object

Link to a resource.

cardTransactions

object

Link to a resource.

first

object

Link to a resource.

object

Link to a resource.

object

Link to a resource.

last

object

Link to a resource.

download

object

Link to a resource.

Headers

object

Location

url

Location of the created resource.

X-Request-ID

uuid

ID of the request, unique to the call, as determined by the initiating party.

Response body

object

tppMessages

array of objects

tppMessages

object

category

string

required

Category of the TPP message category.

ERROR WARNING

code

string

required

Message codes defined for PIS for HTTP Error code 409 (CONFLICT).

STATUS_INVALID

path

string

text

string

length ≤ 500

Additional explaining text to the TPP.

_links

object

A _link object with all available link types.

scaRedirect

object

Link to a resource.

scaOAuth

object

Link to a resource.

confirmation

object

Link to a resource.

startAuthorisation

object

Link to a resource.

startAuthorisationWithPsuIdentification

object

Link to a resource.

updatePsuIdentification

object

Link to a resource.

startAuthorisationWithProprietaryData

object

Link to a resource.

updateProprietaryData

object

Link to a resource.

startAuthorisationWithPsuAuthentication

object

Link to a resource.

updatePsuAuthentication

object

Link to a resource.

startAuthorisationWithEncryptedPsuAuthentication

object

Link to a resource.

updateEncryptedPsuAuthentication

object

Link to a resource.

updateAdditionalPsuAuthentication

object

Link to a resource.

updateAdditionalEncryptedPsuAuthentication

object

Link to a resource.

startAuthorisationWithAuthenticationMethodSelection

object

Link to a resource.

selectAuthenticationMethod

object

Link to a resource.

startAuthorisationWithTransactionAuthorisation

object

Link to a resource.

authoriseTransaction

object

Link to a resource.

self

object

Link to a resource.

status

object

Link to a resource.

scaStatus

object

Link to a resource.

account

object

Link to a resource.

balances

object

Link to a resource.

transactions

object

Link to a resource.

transactionDetails

object

Link to a resource.

cardAccount

object

Link to a resource.

cardTransactions

object

Link to a resource.

first

object

Link to a resource.

object

Link to a resource.

object

Link to a resource.

last

object

Link to a resource.

download

object

Link to a resource.

Headers

object

Location

url

Location of the created resource.

X-Request-ID

uuid

ID of the request, unique to the call, as determined by the initiating party.

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request GET \
2
     --url https://test-openbanking.tbcbank.ge/0.8/v1/payments/aspsp/paymentId/authorisations/authorisationId \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

*/*

200OK

400Bad Request

401Unauthorized

403Forbidden

404Not found

405Method Not Allowed

406Not Acceptable

408Request Timeout

409Conflict

415Unsupported Media Type

429Too Many Requests

500Internal Server Error

503Service Unavailable