To make your first Jenga API call, you need a demo/UAT/test account which you can create on https://v3.jengahq.io/registration
Second, subscribe to your preferred service(s).
Subscribing to Jenga API services
You will need to subscribe to API services before you set up to make a specific API call.
Subscribing to a service calls for mapping it to an account will be debited when making an API call.
Adding your bank account on Jenga
To Add your account on Jenga Hq:
- Navigate to settings on the dashboard page
- Select Accounts
- Then select New Account & follow the prompts
For Test, add the test account 1450160649886
For the Production/ Live environment, add your organization's bank account number
The SWIFT code for Equity Bank Account holders is EQBLKENA.
Generating API Keys on Jenga
To generate API keys:
- Log in to v3.jengahq.io/
- Navigate to Settings
- Click on API Keys
Generate new keys from which a set of API key credentials will be derived i.e The API keys, the consumer secret (password) and merchant code (which is a constant value).
Below the key generation modules, is a public key module hit on it so as to input your public key without headers and footer blocks.
Note: The access token expires within 15 minutes. You'll be acquired to generate again.
The above in place, you can now generate tokens with the endpoint provided in the attached excel sheet. Please pick on the UAT columned endpoints for test and the production endpoints for the Live environment.
Generating bearer tokens on Jenga
To generate your Bearer token, you'll need your:
- Username (Merchant code)
- Password (Customer secret)
- Jenga API Key (See: Generating API Keys)
that you will pass in the Authorization header of your request.
You will get a response back with your Bearer token (Bearer payment token).
You can also refer to developer docs for guidance.
Generate tokens with the endpoints attached. Please pick on the UAT columned endpoints for test and the production endpoints for the Live environment.
Generating signatures on Jenga
To ensure the security of your transactions or requests, we have implemented security controls that we ensure that transactions can only be initiated by you and no one else. To achieve this, we use message signatures.
To generate the signature, you will need to create a private key and public key.
You will share the public key with us and use the private key to generate the signature.
You can use this command OpenSSL genrsa -out privatekey.pem 2048 –nodes to generate the key pair
Use a library like open SSL to generate the signature using your private key and plain text.
Here is the full Jenga Signature Generation Guide.
Start receiving payments on Jenga
Want to go live on Jenga and start receiving payments on Jenga? Follow the Go-Live Steps.
You can also reach out to us on the in-product chat widget on the bottom right-hand side of your screen.