Required configuration#

In order to use Zūm Rails Aggregation you will need to have a valid CustomerId, this information will be provided within your onboarding, if not you can easily grab it from Zūm Portal.

A customer Id for testing looks like this: a3510efb-5edb-4972-96be-a5a91ddfa56a

Basic configuration#

ParameterDescriptionDefault valueRequired
customeridYour CustomerId-yes

The base url for Connector is:


Configure the user experience#

ParameterDescriptionDefault valueRequired
consentWhen true, display the consent page. This page explains to the end user what information will be extracted, as well let the end user agree with the terms & conditionstruefalse
accountselectorDisplay a page to select the preferred account, usually used for EFT payment initiation.truefalse
testinstitutionDisplay Zūm Rails test institution, used while you are testingfalsefalse
adduserinportalAdd connected users in Zūm Rails Portaltruefalse

The accountselector parameter will always be set to "True" by default. To set the Parameter "accountselector" to "False", it is mandatory to specify the parameter adduserinportal = false.

Configure the user interface#

ParameterDescriptionDefault valueRequired
backbuttonDisplay the back button on the left hand top cornerfalsefalse
closebuttonDisplay the close button on the right hand top cornerfalsefalse
logoDisplay the logo on the top of the screentruefalse
buttonbgcolorThe navigation buttons background color#000000false
buttontextcolorThe navigation buttons text color#FFFFFFfalse
logourlYour logo url to be used on the UI. If not informed, Zūm Rails logo is the default one-false
tecUrlYour terms & conditions URL (consent page). When clicked a new tab will be opened-false
institutionsearchDisplay the Institution Search boxtruefalse
finishRredirecturlAn URL to redirect the page after the connection is completed-false

Configure the data to extract#

ParameterDescriptionDefault valueRequired
gettransactionsIf you want to extract transactionstruefalse
getstatementsIf you want to extract pdf statementsfalsefalse
getholderinformationIf you want to extract the account holder name and addresstruefalse
datefromBy default we extract information for the last 12 months. Use this field if you want to specify another range. Format (yyyy-MM-dd)-false

Extra configuration#

ParameterDescriptionDefault valueRequired
extrafield1And extra field so that you can add custom information, later receive it when the connection is completed-false
extrafield2And extra field so that you can add custom information, later receive it when the connection is completed-false

Any parameters that are not true/false, like urls or texts must be encoded.


We recommend you using the Configure page to build your URL. No advanced technical knowledge is required.