Skip to content

This FRENDS task library contains a set of tasks for consuming Nordea bank's web services channel

License

Notifications You must be signed in to change notification settings

CommunityHiQ/Frends.Community.PaymentServices.Nordea

Repository files navigation

Frends.Community.PaymentServices.Nordea

FRENDS task for using payments services of Nordea bank. With the task it's possible to fetch filelists, download files, upload files and delete files.

Installing

You can install the task via FRENDS UI Task View or you can find the nuget package from the following nuget feed 'Nuget feed coming at later date'

Tasks

GetUserInfo

Fetches information on authorized user file types and service IDs.

Task Parameters

Property Type Description Example
Url string URL of the bank's web service http://filetransfer.test.nordea.com/services/CorporateFileService
Certificate Issued By string The issuer of the Base-64 encoded X.509 certificate that should be used for signing the messages
Environment string Target environment (TEST or PRODUCTION) TEST
Customer Id string Unique number identifying the bank's customer 0000000000
Target Id string The logical folder name where the file(s) of the customer are stored in the bank.
Request Id int A unique integer value identifying the request. This value must be unique for three months. 1
Connection timeout seconds int Timeout in seconds to be used for the connection and operation. 30

Result

Property Type Description Example
JToken

DownloadFileList

Downloads a list of files available for download from Nordea.

Task Parameters

Property Type Description Example
Url string URL of the bank's web service http://filetransfer.test.nordea.com/services/CorporateFileService
Certificate Issued By string The issuer of the Base-64 encoded X.509 certificate that should be used for signing the messages
Environment string Target environment (TEST or PRODUCTION) TEST
Customer Id string Unique number identifying the bank's customer 0000000000
Request Id int A unique integer value identifying the request. This value must be unique for three months. 1
File Type string Optional parameter for filtering filelists pain.001.001.02
Target Id string The logical folder name where the file(s) of the customer are stored in the bank.
Start Date string Format: YYYY-MM-DD. Optional parameter for filtering filelists. Files created after will be returned. If this value is null, or unparseable to a DateTime object, no filter is applied. 2018-05-25
End Date string Format: YYYY-MM-DD. Optional parameter for filtering filelists. Files created before will be returned. If this value is null, or unparseable to a DateTime object, no filter is applied. 2018-05-28
Status string Optional parameter for filtering filelist. Valid values are "NEW", "DOWNLOADED" and "ALL". NEW = files not downloaded yet, DOWNLOADED = files already downloaded and ALL = fetch all available files. If no parameter is given or if the status is "ALL", all files will be listed. NEW
Connection timeout seconds int Timeout in seconds to be used for the connection and operation. 30

Result

Property Type Description Example
JToken array Array elements have the following properties: FileReference, TargetId, ParentFileReference, FileType, FileTimestamp, Status

UploadFile

Uploads a file to Nordea

Task parameters

Property Type Description Example
Url string URL of the bank's web service http://filetransfer.test.nordea.com/services/CorporateFileService
Certificate Issued By string The issuer of the Base-64 encoded X.509 certificate that should be used for signing the messages
Environment string Target environment (TEST or PRODUCTION) TEST
Customer Id string Unique number identifying the bank's customer 0000000000
Request Id int A unique integer value identifying the request. This value must be unique for three months. 1
File Input string File input (e.g. XML content of file)
File Type string File type to upload pain.001.001.02
File Encoding string File encoding for the input file utf-8
Target Id string The logical folder name where the file(s) of the customer are stored in the bank.
Connection timeout seconds int Timeout in seconds to be used for the connection and operation. 30

Result

Property Type Description Example
JToken array Array elements have the following properties: CustomerId, Timestamp, ResponseCode, Encrypted, Compressed, AmountTotal, TransactionCount

DownloadFile

Downloads a file or files from Nordea. The webservice supports requests for a single file, multiple files, all files of type and all files. Note: Fetching with multiple file references is not currently supported.

Task Parameters

Property Type Description Example
Url string URL of the bank's web service http://filetransfer.test.nordea.com/services/CorporateFileService
Certificate Issued By string The issuer of the Base-64 encoded X.509 certificate that should be used for signing the messages
Environment string Target environment (TEST or PRODUCTION) TEST
Customer Id string Unique number identifying the bank's customer 0000000000
Request Id int A unique integer value identifying the request. This value must be unique for three months. 1
File Reference string File reference id for the file to be downloaded 123456
File Encoding string File encoding for the input file utf-8
File Type bool Optional parameter for filtering downloaded files pain.001.001.02
Target Id string The logical folder name where the file(s) of the customer are stored in the bank.
Status string Optional parameter for filtering filelist. Valid values are "NEW", "DOWNLOADED" and "ALL". NEW = files not downloaded yet, DOWNLOADED = files already downloaded and ALL = fetch all available files. If no parameter is given or if the status is "ALL", all files will be listed. NEW
Connection timeout seconds int Timeout in seconds to be used for the connection and operation. 30

Result

Property Type Description Example
string File content in string format

License

This project is licensed under the MIT License - see the LICENSE file for details

Building

Clone a copy of the repo

git clone https://github.com/CommunityHiQ/Frends.Community.PaymentServices.Nordea.git

Restore dependencies

nuget restore frends.community.paymentservices.nordea

Rebuild the project

Note: The code cannot be properly tested without a working connection to Nordea's Web Service, so no separate tests are included in the code. See "Testing" for more information.

Create a nuget package

nuget pack nuspec/Frends.Community.Email.nuspec

Testing

Testing and using the tasks requires a working connection to Nordea's Web Service. In order to connect to Nordea's Web Service the following things are needed:

  • An agreement with Nordea. Without an agreement there is no Customer Id, no Target Id and no way to obtain the needed certificate.
  • A client specific (production) certificate. The web service does not have a separate test environment, so the same certificate is used for tests and production use. The easiest way to obtain the certificate is probably using Nordea's security client program. Full instructions can be found from Nordea's web page. The certificate should be installed under Personal/Certificates in the FRENDS agent's certificate store.
  • Nordea root cerficate.

When the certificate is obtained and installed, and the needed ID values are known, the connection to Nordea's web service can be tested with either task GetUserInfo or DownloadFileList, as these only fetch information and do not modify anything at Nordea's end. Assuming there is some material to test with, DownLoadFile and UploadFile can be tested as soon as the connection to the web service works.

When testing - and especially when testing UploadFile - care should be taken that the environment parameter is TEST, as there is no separate test environment for the web service. If, for example, test material is uploaded with environment parameter PRODUCTION, the material will be processed in production.

Note: The url http://filetransfer.test.nordea.com/services/CorporateFileService is only available when Corporate eGateway is used. It is used as the tasks' default value for the url as a small safeguard agains sending requests to production environment unintentionally.

These tasks utilize Nordea's implementation of Web Services channel. Details of Nordea's implementation can be found here. These documents are also backed up in Documents folder.

Contributing

When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

Change Log

Version Changes
1.0.0 Initial version of Nordea WS tasks
1.0.1 Small fixes to namespaces
1.0.2 Fix to download file task
1.0.4 Small fixes to response namespaces
1.0.5 Intermediate version for debugging
1.0.6 Fix to response signature validation
1.0.7 Updated UploadFile result format
1.0.8 Bug fix to UploadFile result format
1.1.0 A number of small fixes to documentation and code

About

This FRENDS task library contains a set of tasks for consuming Nordea bank's web services channel

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages