Commercial Bank of Ethiopia

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

Configure Environment Variables

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

Certificate path

COMMERCIAL_BANK_ETHIOPIA_CERTIFICATE_PATH

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

Url

COMMERCIAL_BANK_ETHIOPIA_URL

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

Configure CBE Credentials via Program FSP Configurations

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.

Configure username/password

To configure the username and password for a specific program use the API call:
POST /api/programs/{programId}/financial-service-provider-configurations with the payload:

{
  "name": "username",
  "value": "[username]"
}

Replace [username] with the username that the client provided.

To configure the password use the same API call with:

{
  "name": "password",
  "value": "[password]"
}

Replace [password] with the password that the client provided.

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.