Servers
Auth
Operations
Get Users
Get all activated users. Requires an admin client - contact BANKSapi for access.
Authorizations
Parameters
Path Parameters
Tenant name plays a role in using the API. The tenant name is a URL component in the management API.
"demo"Query Parameters
Whether or not to also include inactive users
truefalseResponses
Returns an array of User
Encrypt plaintexts
Encrypt a given plaintext for the tenant identified by the given bearer token.
Authorizations
Request Body
Responses
Ciphertext (encrypted plaintext) encoded in Base64
Get Providers
Retrieve a list of and information for all providers.
Authorizations
Responses
Returns an array of providers.
Get Customer
Retrieves the customer object for the authenticated user. It is also the entry point to the deeper functions of the interface.
Authorizations
Responses
Returns customer object of the user.
Customer Bank Access
Operations
Get Bank Accesses
Retrieves all bank accesses for this user.
Authorizations
Responses
The success response contains an collection of bank accesses.
Push transactions for the given product
Pushes transactions for the given product identified by an access and a product ID
Authorizations
Parameters
Path Parameters
ID of the bank access
"d23710a9-8e4b-4595-b01c-dad9499c9fdb""uuid"ID of a banking product
"DE00123456789012345678"Request Body
Responses
Created
Start SCA
Starts the SCA renewal process
Authorizations
Parameters
Header Parameters
The IP address of the customer. Must be a public IP address (IPv4, IPv6)
"154.25.45.133"Path Parameters
ID of the bank access
"d23710a9-8e4b-4595-b01c-dad9499c9fdb""uuid"Query Parameters
Required for non-REG/Protect tenants. Get redirected here after a Redirect SCA.
"https://demo-tenant.com/callback?state=123""url"Flag to ignore saved TAN-settings and query them.
"true"Indicator if transactions older than 90 days should be fetched. Best used when first creating the bank access to avoid unnecessary SCAs during refresh operations.
"none""all""paymentAccounts"Request Body
Responses
HTTP status 201 (Created) is returned together with the HTTP header Location. Under the URL specified in the header, the added bank accesses can be queried analogously by means of an HTTP GET call.
Customer Bank Access Payment
Operations
Initiate a single transfer
Initiates a payment for the given bank access, without providing access credentials
Authorizations
Parameters
Header Parameters
The IP address of the customer. Must be a public IP address (IPv4, IPv6)
"154.25.45.133"If set to "true", the bank should reject the payment if there are insufficient funds. If set to "false", the bank may wait for a certain period for funds to arrive. This parameter may be ignored by the bank.
"true"Path Parameters
ID of the bank access
"d23710a9-8e4b-4595-b01c-dad9499c9fdb""uuid"ID of a banking product
"DE00123456789012345678"Query Parameters
Required for non-REG/Protect tenants. Get redirected here after a Redirect SCA.
"https://demo-tenant.com/callback?state=123""url"Flag for REG/Protect to control whether fields on the frontend are editable
"false"Flag for REG/Protect to control whether transfers can be entered without interaction. Currently only supported for EBICS.
"false"Unique UUID for the payment. Required for non-REG/Protect tenants. When provided, the same ID must be used for related VOP (Verification of Payee) requests.
"d308a7ae-b762-4a20-8996-7fa22aed6b73""uuid"Request Body
Responses
Returns object with the transfer status
Customer Ueberweisung
Legacy endpoints, that will be replaced by the endpoints in 'Customer Payment'
Create Transfer
Creates a payment (i.e. initializes a SEPA transfer).
Authorizations
Parameters
Header Parameters
The IP address of the customer. Must be a public IP address (IPv4, IPv6)
"154.25.45.133"Path Parameters
ID of a provider
"00000000-0000-0000-0000-000000000000""uuid"ID of a banking product
"DE00123456789012345678"Query Parameters
Required for non-REG/Protect tenants. Get redirected here after a Redirect SCA.
"https://demo-tenant.com/callback?state=123""url"Flag for REG/Protect to control whether fields on the frontend are editable
"false"Unique UUID for the payment. Required for non-REG/Protect tenants. When provided, the same ID must be used for related VOP (Verification of Payee) requests.
"d308a7ae-b762-4a20-8996-7fa22aed6b73""uuid"Request Body
Responses
Returns object with the transfer status
Customer Payment
Operations
Initiate Single Transfer
Initiates a single transfer (e.g. a SEPA transfer).
Authorizations
Parameters
Header Parameters
The IP address of the customer. Must be a public IP address (IPv4, IPv6)
"154.25.45.133"If set to "true", the bank should reject the payment if there are insufficient funds. If set to "false", the bank may wait for a certain period for funds to arrive. This parameter may be ignored by the bank.
"true"Query Parameters
Required for non-REG/Protect tenants. Get redirected here after a Redirect SCA.
"https://demo-tenant.com/callback?state=123""url"Flag to ignore saved TAN-settings and query them.
"true"Flag for REG/Protect to control whether fields on the frontend are editable
"false"Unique UUID for the payment. Required for non-REG/Protect tenants. When provided, the same ID must be used for related VOP (Verification of Payee) requests.
"d308a7ae-b762-4a20-8996-7fa22aed6b73""uuid"Request Body
Responses
Returns object with the transfer status
Get Consent
Get the current status of the consent, without polling the provider
Authorizations
Parameters
Path Parameters
ID of the consent
"3e97fa51-ce7b-42a0-9101-50fd67dbc3e7""uuid"Responses
Returns the current status of the consent.