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.
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'
Fetches information on authorized user file types and service IDs.
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 |
Property | Type | Description | Example |
---|---|---|---|
JToken |
Downloads a list of files available for download from Nordea.
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 |
Property | Type | Description | Example |
---|---|---|---|
JToken array | Array elements have the following properties: FileReference, TargetId, ParentFileReference, FileType, FileTimestamp, Status |
Uploads a file to Nordea
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 |
Property | Type | Description | Example |
---|---|---|---|
JToken array | Array elements have the following properties: CustomerId, Timestamp, ResponseCode, Encrypted, Compressed, AmountTotal, TransactionCount |
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.
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 |
Property | Type | Description | Example |
---|---|---|---|
string | File content in string format |
This project is licensed under the MIT License - see the LICENSE file for details
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 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.
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.
- Fork the repo on GitHub
- Clone the project to your own machine
- Commit changes to your own branch
- Push your work back up to your fork
- 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!
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 |