libeufin

Integration and sandbox testing for FinTech APIs and data formats
Log | Files | Refs | Submodules | README | LICENSE

README.md (1373B)


      1 # LibEuFin Test Bench
      2 
      3 ## Interactive EBICS test
      4 
      5 To add a platform write a minimal configuration file at `testbench/test/conf/PLATFORM.conf` such as :
      6 
      7 ``` ini
      8 # testbench/test/conf/PLATFORM.conf
      9 [nexus-ebics]
     10 currency = CHF
     11 
     12 # Bank
     13 HOST_BASE_URL = https://isotest.postfinance.ch/ebicsweb/ebicsweb
     14 BANK_DIALECT = postfinance
     15 
     16 # EBICS IDs
     17 HOST_ID = PFEBICS
     18 USER_ID = PFC00563
     19 PARTNER_ID = PFC00563
     20 
     21 IBAN = CH7789144474425692816
     22 BIC = POFICHBEXXX
     23 NAME = LibEuFin Tests
     24 ```
     25 
     26 To start the interactive EBICS test run :
     27 
     28 ``` sh
     29 make testbench platform=PLATFORM
     30 ```
     31 
     32 If HOST_BASE_URL is one a known test platform we will generate and then offer to reset client private keys to test keys registration, otherwise, we will expect existing keys to be found at `testbench/test/PLATFORM/client-ebics-keys.json`.
     33 
     34 This minimal configuration will be augmented on start, you can find the full documentation at `testbench/test/PLATFORM/ebics.conf`.
     35 
     36 By default, the testbench will use a random dummy IBAN when issuing transactions, but you can specify a real IBAN for real-life testing in the testbench configuration at `testbench/test/config.json` :
     37 
     38 ``` json
     39 // testbench/test/PLATFORM/ebics.conf
     40 {
     41     "payto": {
     42         "CHF": "payto://iban/CH4189144589712575493?receiver-name=John%20Smith",
     43         "EUR": "payto://iban/DE54500105177452372744?receiver-name=John%20Smith"
     44     }
     45 }
     46 ```