setup-ebics-at-postfinance.rst (3070B)
1 Setup EBICS at PostFinance test platform 2 ######################################## 3 4 In this tutorial, we will set up one EBICS 3 account at the PostFinance 5 test platform, in order to test the ``postfinance`` dialect from ``libeufin-nexus``. 6 7 The first requirement is to create one account `there <https://isotest.postfinance.ch>`_. 8 It is advised to set the language as English, as this tutorial is meant 9 for the international audience. 10 11 Set the language in the drop-down menu and navigate to the registration 12 section as it is shown below: 13 14 .. image:: set-english-and-register.png 15 16 Even if the above page doesn't welcome you in English, the two boxes in the 17 screenshot will still hold their position, so please look for box #1 to 18 set the language and for box #2 to get the page that offers to register. 19 20 After a successful registration, an IBAN needs to be associated with 21 the user just created. Likely after the first login, the following 22 page should appear. Click then on box #2. 23 24 .. note:: 25 26 The navigation bar in the screenshot below is ubiquitous, 27 so click on box #1 if the depicted page did not show up automatically. 28 29 .. image:: no-accounts.png 30 31 If the following page appears, please obtain a checksum-valid but fictitious 32 Swiss IBAN and enter it as indicated by box #1 and then save it (box #2). 33 34 .. _my-iban: 35 36 .. image:: set-IBAN.png 37 38 If the bank responds with a successful message, the next step is to enable 39 EBICS 3 and set the format of the ISO20022 documents. 40 41 .. note:: 42 43 There is no "use EBICS 3" setting since EBICS 3 is a "side effect" 44 of choosing one particular ISO format for banking records. 45 46 To use EBICS 3, click the navigation bar item highlighted in the 47 following screenshot. 48 49 .. image:: set-ISO-2019-0.png 50 51 The following page should appear, where the ISO format can be specified 52 as it is depicted in the following screenshot. 53 54 .. image:: set-ISO-2019-1.png 55 56 After having saved the setting, proceed now to set the flavor 57 of payment confirmations. This setting instructs the bank to define 58 particular XML nodes when it releases the payment confirmations. Even 59 if each document is ISO20022, this step is essential because ISO20022 60 has many optional fields and client and bank must agree on which fields 61 appear in the documents. 62 63 Hover on box #1 and then click on box #2. 64 65 .. image:: camt.054-style-0.png 66 67 If the following page appears, please set everything as it is shown below: 68 69 .. image:: camt.054-style-1.png 70 71 .. _get-ebics-ids: 72 73 The last step is to retrieve the user's EBICS identifiers, namely the 74 EBICS user and partner IDs. Hover on box #1 and then click on box #2. 75 76 .. image:: get-EBICS-IDs-0.png 77 78 At the first access, the following page should appear. Simply create 79 EBICS access and continue to the next step. 80 81 .. image:: enable-EBICS.png 82 83 After having obtained the following page, finally the EBICS identifiers 84 are shown in box #1. 85 86 .. image:: get-EBICS-IDs-1.png 87 88 Finally, box #2 contains the bank keys fingerprints. These are 89 important to check that the client, along the keying process, has obtained 90 the right bank keys.