Documentation

1Sign Up for ISR

1.1Overview

ISR Payment is a swiss-specific payment scheme where your clients pay their invoices with a unique reference number. This allows the reconciliation of those payments in a fast and automated way. The merchant banks provides reconciliation file that allow the automatic reconciliation of open invoices. We are able to process the following file formats:

  • ISO 20022 (camt.053.001.04) including Detail Records

  • ISO 20022 (camt.054.001.04)

  • V11

In terms of ESR products you are able to process the following ESR types with the application

  • (B)ESR

  • (B)ESR+ (without amount)

  • ESR EUR

  • ESR+ EUR (without amount)

1.2Signup for ISR

If you have a banking account at a bank seated in Switzerland they offer ISR payments for you. You have to get in touch with your account manager to apply for the ISR Participant Number and additional details.

You have to distinguish between ESR with PostFinance and BESR with any other bank.

1.2.1ESR with PostFinance

For ESR payments with PostFinance you can signup for a participant number in your account directly with your account manager at PostFinance. When you sign up for the participant number and the ESR scheme make sure that you select the ISO 20022 (camt.053.001.04) including Details as report format.

Additionally you have the option to receive the payment reports via PostFinance’s File Delivery Service (FDS). If you sing up for this you find more information about the configuration below. This allows us to receive the payments automatically and reconcile them directly. In case you want to have them delivered to your e-banking this is also possible, in this case you will have to upload them manually periodically.

1.2.2BESR - Processing ESR via a Bank

You can also process ISR payments through your bank. In this case the scheme is called BESR. BESR uses different payment templates. In the BESR scheme you have to provide the Payment For information where you provide information about your bank. Additionally you receive the Participant Number from your bank.

Differing from the ESR scheme the reference number has to be structured differently as the first 6 digits of the ESR prefix identify the merchant’s bank account. The remaining 20 digits can then be filled by the merchant. The checksum is automatically generated by us.

2ISR Processor Configuration

Before you can start with the configuration of the ISR Processor you have to make sure that the Feature ISR Processor is activated on your in your space. You can do so in the feature menu.

2.1Configuration of the ISR Processor

Once the merchant is signed up for ESR we can start to configure the processor and the connector. First of all you have to create a connector under Space > Payment > Configuration > Processors. Search here for the ISR Processor.

In the configuration of the ISR Processor there are a multitude of settings. The most important settings are the following:

  • Print Base Slip Template: This setting controls whether the ESR Slip is printed on the PDF. In case you are using pre-printed slips from you should set this setting to off.

  • Participant Number: Once you are signed up for ISR with your payment institute you receive the participant number that you fill in here. It should have the format XX-XXXXXX-X.

  • Bank Account Number / Prefix: This field is optional and should only be filled in case you are processing the ISR payments via a Bank and not PostFinance or if you specifically want to have a prefix in your ESR numbers.

  • Deposit For: The deposit for is printed to the ISR slip. In case the payment is routed via a bank than this has to be the bank name. In case the payment is directly paid to a merchants PostFinance account the merchants address and company name needs to be provided.

  • Beneficiary: Only fill this field in case you are routing the payments through a bank (BESR).

2.2Printer Settings

In case you are printing the payment slips and send them to your customer you should make sure that the OCR information on the slip is within the acceptance range otherwise it could happen that you will be charged additional costs if your clients use the slips to pay at the counter. As the printing is very specific to your operating system and your printer this might have to be adjusted. For this you can set the X and Y-Offset to position the ISR slips horizontally and vertically.

2.3Connector Settings

Once the processor is created, you can go ahead and configure the connector. There are two different connector you can choose from.

  • ISR Bank Transfer: The ISR Bank Transfer is used for pre-payment scenarios where you create an invoice document but your client has to pay first using the ISR slip. Once the money has arrived and could be reconciled the transaction will switch in to the Fulfill state for further processing.

  • * ISR Invoice:* The ISR Invoice is the standard process where you send your customer the invoice that has to be paid in a specified payment term.

In the connector you are able to configure additional settings. You find more information and documentation in the configuration directly. This is why only the very important settings are further explained in detail here:

  • Enable Dunning: You have the option to enable the dunning feature of the application. In this case the system will create a dunning case once your client did not pay the invoice during the payment term. In order to use the dunning system you will have to setup the dunning flows and levels. More information can be found in the Dunning Documentation.

  • ISR Printing: You have the option to print the ISR automatically when a transaction is created via a cloud printer. You do have the option to print the page containing the ISR payment slip on a different printer as those are normally printed on a different printer tray. More details can be found in the printer documentation.

  • Payment Term: The payment term defines when the invoice has to be paid before it switches into the dunning or failed state.

  • Allowed Difference: This setting defines the maximal difference between the paid amount by the customer and the captured amount on the invoice. As long as the amount is within this limit then the system marks the invoice still as fully paid even though there might be a little difference to the captured amount.

Once the settings on the connector are stored you are able to offer the ISR payments to your clients. The next section covers everything about the processing if the payment reports that are generated by your bank.

3ISR Processing

Once the processor is set up you can configure everything about the reports and the processing under Space > Payment > ISR Processing.

3.1Upload ISR Reports and Reconciliation

ISR Reports can be uploaded manually under Reports.

You are able to upload v11 and ISO 20022 (camt.053.001.04) files. Once the upload is finished the reports will be scheduled for processing. This can take some time.

After the files are processed you find a list of processed records under Transaction Records

As soon as the invoice could be matched the transaction will be marked as paid and the system automatically creates a payment receipt.

Note
For some PostFinance accounts we allow that the files are automatically fetched via the File Delivery Service More Information about the setup can be found below.

3.2Download ISR Reports

In case you do want to download the original reports again you can do that by opening a report the Report List. The download button will give you access to the original file.

Note
This can now be used to upload in any other systems in case you are migrating form another system and you do still need to upload payments during the migration period.

3.3Manually Resolving Records

The transaction reports in the report file from the bank are available under Transaction Records.

Based on the reference number the matching of open invoice happens automatically. However, in certain cases the matching can not be done automatically and the items appear as unresolved. This will automatically trigger a manual tasks. Unresolved items appear mainly in the following occasions:

  • In case the reference number can not be found in your transaction list. In this case it might be that you imported the wrong statement or you do have other systems that create ESR numbers. You can manually discard the items if you open the item and click on discard. Items in the state Discarded will be ignored by the application.

  • In case the client re-uses the reference number twice for an invoice that is already paid. In this case you can either link the transaction manually to the correct transaction in case the client used the number for an old invoice but there is in fact an unpaid invoice. Otherwise you can also link it to an already paid invoice. However, it is your job now to organize the refund of the money in case it was overpaid.

Once the transaction is matched the system automatically creates a payment receipt.

Create Integration
Figure 1. Once the transaction is matched the system automatically creates a payment receipt.

4Automated Fetching of Transactions

The fetching of transaction reports can also be automated. Currently this is only available for FDS with PostFinance but this will very soon be available for other banks as well.

Create Integration
Figure 2. See an overview of the resolved, unresolved and discarded transaction in the transaction records overview.

4.1FDS Setup

For PostFinance you have the option to activate the automated fetching of transaction reports. This is done via the File Delivery Service of PostFinance. In order to setup the automated fetching you have to apply for an FDS account with your account manager first. As the setup at PostFinance asks for various details regarding the account configuration we created a mock singup for FDS and ESR form that you can use: FDS template for automatic delivery

Note
Please fill in the template on page one and sign the document on page four. On page one you need to put only your information. Please do not fill anything into section two (Datenempfänger).

Once the account has been setup you will be informed by PostFinance. You can now navigate to the Fetching Configuration.

Create here your fetching configuration using PostFinance FDS. Type here your username that was assigned to you by PostFinance. Once you stored the configuration you can generate your public key and download it to send it to fds@post.ch.

As soon as the setup is completed at PostFinance the fetching of the records will start automatically.

Create Integration
Figure 3. After you configured the FDS fetching configuration. To download the public key or manage the keys you have to click on Manage Keys.

The fetching configuration is also the place where you are able to manage your public keys. By clicking on manage keys you are able to generate a new keys, download keys and disable keys you no longer want. However, keep in mind that you will have to send the updated key to fds@post.ch otherwise it will no longer work.

Create Integration
Figure 4. In the manage key menu you are able to generate new keys, disable old keys and download them.