ASPSPs

Open Banking Providers

Used by TPP for obtaining the list of ASPSPs which support OpenBanking standard.

CURL

curl -i \ -H "Content-Type: application/json" \ -H "Client-Id: client_application_identifier" \ -H "x-fapi-interaction-id: some-uuid" \ -H "x-fapi-auth-date: Sun, 10 Sep 2017 19:43:31 GMT" \ -H "x-fapi-customer-ip-address: 104.25.212.99" \ -d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.A6egkZDnNh4-FiOA3gW0nrG9biXWl-zRjMG5Bh8d4W-BveI_V_Q5YUNU3vasheF9TtPPdkN__xnRLlez8tXL8Eyb0BSGU3CwcAfceuNW1kZyweoxasnvtJATaQIjbuAIWKpy3UB8znksuO2o-i5wlByBG_t9QM1DOLpG-Sf4Rrfg8TtJkRm3E6HCYlL0_Dn1EjlLnMyzs66oEvY-8pthuAk651HAhOsUEkHJE5-vNYw2fYSU6rs8npCPz4u5EqnkvSAbXH4sfLPa4m6ovZX2m5ZNSc1vKQHL4XjIhtSe37dy_-w4N9p6pWikBP3jG9kT0K7D3yAZusVxY_T0IXr9BA' \ -X GET "/api/open-banking/v3.1.11/aspsps"

curl -i  \ 
 -H "Content-Type: application/json" \ 
 -H "Client-Id: client_application_identifier" \ 
 -H "x-fapi-interaction-id: some-uuid" \ 
 -H "x-fapi-auth-date: Sun, 10 Sep 2017 19:43:31 GMT" \ 
 -H "x-fapi-customer-ip-address: 104.25.212.99" \ 
 -d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.A6egkZDnNh4-FiOA3gW0nrG9biXWl-zRjMG5Bh8d4W-BveI_V_Q5YUNU3vasheF9TtPPdkN__xnRLlez8tXL8Eyb0BSGU3CwcAfceuNW1kZyweoxasnvtJATaQIjbuAIWKpy3UB8znksuO2o-i5wlByBG_t9QM1DOLpG-Sf4Rrfg8TtJkRm3E6HCYlL0_Dn1EjlLnMyzs66oEvY-8pthuAk651HAhOsUEkHJE5-vNYw2fYSU6rs8npCPz4u5EqnkvSAbXH4sfLPa4m6ovZX2m5ZNSc1vKQHL4XjIhtSe37dy_-w4N9p6pWikBP3jG9kT0K7D3yAZusVxY_T0IXr9BA' \ 
-X GET "/api/open-banking/v3.1.11/aspsps"

Example of response

{"Data":[{"AspspCode":"ob_demobank","Name":"Open Banking Demobank","Status":"live","LogoUrl":"https://priora.saltedge.com/images/demobank_logo.svg","CountryCode":"XF","SupportedFlows":["AIS","PIS"],"SandboxCredentials":[{"AuthorisationType":"oauth","RequiredFields":[{"Code":"required_field","Example":"reqField"}],"MfaFields":[{"Code":"mfa_field","Example":"mfaField"}]}],"PisParams":{"ObPaymentsProducts":["domestic-payments","international-payments"],"DomesticInstruments":["UK.OBIE.BACS","UK.OBIE.CHAPS","UK.OBIE.FPS"],"InternationalInstruments":["UK.OBIE.SWIFT"],"CreditorIdentificationSchemes":["UK.OBIE.SortCodeAccountNumber","UK.OBIE.IBAN","UK.OBIE.PAN","UK.OBIE.BBAN"]}}]}

Request

GET /api/open-banking/v3.1.11/aspsps

Headers

Header	Type	Description
`Accept`	string, optional	Media type that is acceptable for the response. Default value: application/json
`x-fapi-interaction-id`	string, optional	An RFC4122 UID used as a correlation Id.
`Client-Id`	string, required	Client application identifier. Can raise: ResourceNotFound
`x-fapi-auth-date`	string, optional	The time when the PSU last logged in with the TPP. Supplied as HTTP-date (RFC7231), e.g. Sun, 10 Sep 2017 19:43:31 GMT.
`x-fapi-customer-ip-address`	string, optional	The PSU's IP address if the PSU is currently logged in with the TPP. Identifies user presence for the data fetch.

Request parameters

SupportedFlows (path)

array, optional

ASPSP available flows. Default value: ["AIS", "PIS", "PIIS"] Allowed values: AIS, PIS, PIIS

Response headers

Header	Type	Description
`Content-Type`	string, required	The media type of the body of the request.
`Retry-After`	integer, optional	Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request.

Response

Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.

Data

array, required

Wrapper for the data.

AspspCode

string, required

ASPSP Code to use in the salt edge_endpoint. Can raise: FieldInvalid

Name

string, required

ASPSP business name. Can raise: FieldInvalid

Status

string, required

ASPSP status. Allowed values: live, test, sandbox Can raise: FieldInvalid

LogoUrl

string, required

ASPSP logo location. Can raise: FieldInvalid

SupportedFlows

array, required

ASPSP available flows. Allowed values: AIS, PIS, PIIS

CountryCode

string, required

ASPSP's country code. Can raise: FieldInvalid

CreditorAgentRequired

boolean, required

Equals 'true' if CreditorAgent parameter for International Payments is required

Data

object, optional

Wrapper for the data.

ObPaymentsProducts

array, required

Payment products supported by ASPSP Allowed values: domestic-payments, international-payments, domestic-scheduled-payments, international-scheduled-payments, domestic-standing-orders, international-standing-orders

DomesticInstruments

array, required

LocalInstruments for domestic payments supported by ASPSP

InternationalInstruments

array, required

LocalInstruments for international payments supported by ASPSP

CreditorIdentificationSchemes

array, required

Identification schemes of Creditor supported by ASPSP

Related Errors

Class	Code	Description
ResourceNotFound	400	Specified resource doesn't exist.

Open Banking Provider's Supported Permissions

Used by TPP for obtaining the list of ASPSP's supported permissions.

CURL

curl -i \ -H "Content-Type: application/json" \ -H "Client-Id: client_application_identifier" \ -H "x-fapi-interaction-id: some-uuid" \ -d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.tu10b-OWGs3ydr-gQ1xexHnvMtP29vqYXhaAijslSDuxMh3mF3QZZkiZdaPcrD7YvXujTKR2Oz3nPnzq53h-Hf6BbUmBDjoyHPH8wU_3DzsjPoaCBHcLcuk5I929y6exK9M3UTA42rrgw2FmFfxPKib13SwkjFA749OcCXlsa_L5qkU77el433t-GOOqVdR44326HdR6OO5uKrMpb8pRY28MrhTZSIzW2F1HgIZbuq_10ebAWbOMTj5JbMKJ_TwB61tlCqO92pZIIFwdVluvSb1gjaV5SEZGVGS3YAAzY-nRwg56S54X6rjYB8pD-BfQUCQY7OVqinNirp5hg_cXQg' \ -X GET "/api/open-banking/v3.1.11/aspsps/:provider_code/permissions"

curl -i  \ 
 -H "Content-Type: application/json" \ 
 -H "Client-Id: client_application_identifier" \ 
 -H "x-fapi-interaction-id: some-uuid" \ 
 -d 'eyJhbGciOiJQUzI1NiIsImtpZCI6InRlc3QifQ.e30.tu10b-OWGs3ydr-gQ1xexHnvMtP29vqYXhaAijslSDuxMh3mF3QZZkiZdaPcrD7YvXujTKR2Oz3nPnzq53h-Hf6BbUmBDjoyHPH8wU_3DzsjPoaCBHcLcuk5I929y6exK9M3UTA42rrgw2FmFfxPKib13SwkjFA749OcCXlsa_L5qkU77el433t-GOOqVdR44326HdR6OO5uKrMpb8pRY28MrhTZSIzW2F1HgIZbuq_10ebAWbOMTj5JbMKJ_TwB61tlCqO92pZIIFwdVluvSb1gjaV5SEZGVGS3YAAzY-nRwg56S54X6rjYB8pD-BfQUCQY7OVqinNirp5hg_cXQg' \ 
-X GET "/api/open-banking/v3.1.11/aspsps/:provider_code/permissions"

Example of response

{"Data":[{"SupportedPermissions":["ReadAccountsBasic","ReadAccountsDetail","ReadBalances","ReadTransactionsBasic","ReadTransactionsCredits","ReadTransactionsDebits","ReadTransactionsDetail","ReadBeneficiariesDetail","ReadBeneficiariesBasic","ReadDirectDebits","ReadStandingOrdersDetail","ReadStandingOrdersBasic","ReadParty","ReadScheduledPaymentsBasic","ReadScheduledPaymentsDetail"]}]}

Request

GET /api/open-banking/v3.1.11/aspsps/:provider_code/permissions

Headers

Header	Type	Description
`Accept`	string, optional	Media type that is acceptable for the response. Default value: application/json
`x-fapi-interaction-id`	string, optional	An RFC4122 UID used as a correlation Id.
`Client-Id`	string, required	Client application identifier in Salt Edge PSD2 Compliance. Should be used to get public key for Authorization header validation. Can raise: ResourceNotFound
`x-fapi-auth-date`	string, optional	The time when the PSU last logged in with the TPP. Supplied as HTTP-date (RFC7231), e.g. Sun, 10 Sep 2017 19:43:31 GMT.
`x-fapi-customer-ip-address`	string, optional	The PSU's IP address if the PSU is currently logged in with the TPP. Identifies user presence for the data fetch.

Request parameters

provider_code (path)

string, required

ASPSP code.

Response headers

Header	Type	Description
`Content-Type`	string, required	The media type of the body of the request.
`Retry-After`	integer, optional	Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request.

Response

Upon successful request, 200 status code will be returned. See ‘Related Errors’ table for other possibilities.

Data

object, required

Wrapper for the data.

SupportedPermissions

array, required

ASPSP supported permissions. Allowed values: ReadAccountsBasic, ReadAccountsDetail, ReadBalances, ReadTransactionsBasic, ReadTransactionsCredits, ReadTransactionsDebits, ReadTransactionsDetail, ReadBeneficiariesDetail, ReadBeneficiariesBasic, ReadDirectDebits, ReadStandingOrdersDetail, ReadStandingOrdersBasic, ReadParty, ReadScheduledPaymentsBasic, ReadScheduledPaymentsDetail

Related Errors

Class	Code	Description
ResourceNotFound	400	Specified resource doesn't exist.