Developer Docs

English

Español

English

Español

Appearance

List of ASPSPs​

GET
/aspsp/v1/aspsps

Lists the ASPSPs (banking entities) available through Zertiban's PSD2 connectivity. Used to populate bank selectors and to validate the aspsp value referenced when creating payment flows.

Paginated list of the Account Servicing Payment Service Providers (ASPSPs) the consuming business can operate with. Each result exposes the ASPSP uuid (the same value the API expects in flow and operation payloads) together with its name, commercialName, icon and known aliases.

Autorizaciones​

OAuth2

OAuth2 security scheme

clientCredentials Flow
Token URL"/api/v2/auth/token"
Scopes:
  • "zertiban-api"Access to the API

Parámetros​

Header Parameters

x-tenant-id*

Organization UUID retrieved

Tipo
string
Requerido
Formato
"uuid"
Longitud máx.
255

Query Parameters

q_businessUuid*
Tipo
string
Requerido
Formato
"uuid"
Longitud máx.
100
q_countryCode*
Tipo
string
Requerido
Longitud mín.
2
Longitud máx.
2
q_scope*
Tipo
string
Requerido
Valores válidos
"AIS""PIS"
q_type*
Tipo
string
Requerido
Valores válidos
"SINGLE_PAYMENT""FUTURE_PAYMENT""TRANSACTIONS""ACCOUNTS""BALANCES""BALANCES_ACCOUNTS""TRANSACTIONS_BALANCES""TRANSACTIONS_ACCOUNTS""TRANSACTIONS_ACCOUNTS_BALANCES"
q_product
Tipo
string
Valores válidos
"SEPA_CREDIT_TRANSFER""INSTANT_SEPA_CREDIT_TRANSFER""GLOBAL_CONSENT""BANK_OFFERED_CONSENT""DETAILED_CONSENT"
limit

Number of results to return per page (default is 10)

Tipo
integer
Por defecto
10
Mínimo
1
offset

Number of items to skip before starting to collect the result set (default is 0)

Tipo
integer
Por defecto
0
Mínimo
0
sort_by

Comma-separated list of fields to sort by

Tipo
string
Valores válidos
"name""commercialName"
sort_dir

Direction of sorting, ASC or DESC

Tipo
string
Valores válidos
"ASC""DESC"

Respuestas​

ASPSP list successfully retrieved

application/json
JSON
{
  
"results": [
  
  
{
  
  
  
"uuid": "string",
  
  
  
"name": "string",
  
  
  
"commercialName": "string",
  
  
  
"icon": "string",
  
  
  
"aliases": [
  
  
  
  
"string"
  
  
  
]
  
  
}
  
],
  
"total": 0
}

Playground​

Autorización
Headers
Variables
Key
Value

Ejemplos​