Commercial Bank of Ethiopia - global-121/121-platform GitHub Wiki

This page contains information about configuring the Commercial Bank of Ethiopia (CBE) FSP integration in a 121 Platform Instance.

For the CBE FSP integration to work for any program, some settings need to be configured via environment variables:

COMMERCIAL_BANK_ETHIOPIA_CERTIFICATE_PATH=/var/ssl/certs/...

The value is the location of the TLS certificate needed for the connection to work. CBE provides this certificate.

COMMERCIAL_BANK_ETHIOPIA_URL=https://...

The value is the base URL of CBE's API. The 121 Development Team knows the correct value.

The client will have received authentication credentials (a username and password) for production use, to be configured for a program, or to be used for all their programs. This username and password needs to be configured for every program that uses the CBE FSP integration.

Use this API call:

POST /api/programs/<programId>/fsp-configurations/<fsp-configuration-name>/properties

To configure the username, use the API call with this payload: (Replace MY-CLIENT-USERNAME with the username that the client provided.)

[
  {
    "name": "username",
    "value": "MY-CLIENT-USERNAME"
  }
]

To configure the password use the API call with: (Replace MY-CLIENT-PASSWORD with the password that the client provided.)

[
  {
    "name": "password",
    "value": "MY-CLIENT-PASSWORD"
  }
]

If there is no configured username and password for the program then the payment is going to fail for PAs and it will display an error message about this on the screen.