Equity_Jenga Package¶

Jenga Submodules¶

equity_jenga.api.auth¶

class equity_jenga.api.auth.JengaAuth(authorization_token: str, merchant_code: str, env: str, private_key='/home/african/.JengaApi/keys/privatekey.pem', sandbox_url='https://sandbox.jengahq.io', live_url='', *args, **kwargs)[source]¶

Bases: object

signature(request_hash_fields: tuple)[source]¶

Build a String of concatenated values of the request fields with following order: as specificied by the API endpoint The resulting text is then signed with Private Key and Base64 encoded.

Takes a tuple of request fields in the order that they should be concatenated, hashes them with SHA-256,signs the resulting hash and returns a Base64 encoded string of the resulting signature

equity_jenga.api.auth.generate_key_pair()[source]¶: Generates a Public/Public RSA Key Pair which is store in the current User’s HOME directory under the .JengaAPI/keys/ Directory

equity_jenga.api.account_services.balances¶

class equity_jenga.api.account_services.balances.AccountBalance(authorization_token: str, merchant_code: str, env: str, private_key='/home/african/.JengaApi/keys/privatekey.pem', sandbox_url='https://sandbox.jengahq.io', live_url='', *args, **kwargs)[source]¶

Bases: auth.JengaAuth

authenticate(countryCode, accountId) → dict[source]¶

available(countryCode, accountId) → dict[source]¶

Retrieve the current and available balance of an account

200 Success Response Schema

{
    "currency": "KES",
    "balances": [
        {
            "amount": "997382.57",
            "type": "Current"
        },
        {
            "amount": "997382.57",
            "type": "Available"
        }
    ]
}

get_opening_and_closing(accountId, countryCode, date)[source]¶

Example Request

{
"countryCode": "KE",
"accountId": "0011547896523",
"date": "2017-09-29"
}

Example Response

{
    "balances": [
        {
            "type": "Closing Balance",
            "amount": "10810.00"
        },
        {
            "type": "Opening Balance",
            "amount": "103.00"
        }
    ]
}

equity_jenga.api.account_services.statements¶

class equity_jenga.api.account_services.statements.FullStatement(authorization_token: str, merchant_code: str, env: str, private_key='/home/african/.JengaApi/keys/privatekey.pem', sandbox_url='https://sandbox.jengahq.io', live_url='', *args, **kwargs)[source]¶

Bases: auth.JengaAuth

authenticate(accountNumber, countryCode, toDate)[source]¶

retrieve(payload)[source]¶

Example Payload

{
    "countryCode": "KE",
    "accountNumber": "0011547896523",
    "fromDate": "2018-01-18",
    "toDate": "2018-04-19",
    "limit": 20,
    "reference": "",
    "serial": "",
    "postedDateTime": "",
    "date": "",
    "runningBalance": {
        "currency": "",
        "amount": 0.0
    }
}

Example Response

{
    "accountNumber": "0011547896523",
    "currency": "KES",
    "balance": 997382.57,
    "transactions": [
        {
            "reference": 541,
            "date": "2018-07-13T00:00:00.000",
            "description": "EQUITEL-BUNDLE/254764555383/8755",
            "amount": 900,
            "serial": 1,
            "postedDateTime": "2018-07-13T09:51:27.000",
            "type": "Debit",
            "runningBalance": {
                "currency": "KES",
                "amount": 1344.57
            }
        },
        {
            "reference": "S4921027",
            "date": "2018-07-18T00:00:00.000",
            "description": "EAZZY-AIRTIME/EQUITEL/254764555383/100000939918/18",
            "amount": 200,
            "serial": 1,
            "postedDateTime": "2018-07-18T16:27:18.000",
            "type": "Debit",
            "runningBalance": {
                "currency": "KES",
                "amount": 1144.57
            }
        },
        {
            "reference": 5436,
            "date": "2018-07-19T00:00:00.000",
            "description": "CREDIT TRANSFER",
            "amount": 1000000,
            "serial": 2,
            "postedDateTime": "2018-07-19T12:01:47.000",
            "type": "Credit",
            "runningBalance": {
                "currency": "KES",
                "amount": 1001144.57
            }
        }
    ]
}

class equity_jenga.api.account_services.statements.MiniStatement(authorization_token: str, merchant_code: str, env: str, private_key='/home/african/.JengaApi/keys/privatekey.pem', sandbox_url='https://sandbox.jengahq.io', live_url='', *args, **kwargs)[source]¶

Bases: auth.JengaAuth

authenticate(countryCode, accountNumber)[source]¶

retrieve(countryCode, accountNumber)[source]¶

Example Response

{
    "accountNumber": "0011547896523",
    "currency": "KES",
    "balance": 1000,
    "transactions": [
        {
            "chequeNumber": null,
            "date": "2017-01-01T00:00:00",
            "description": "EAZZY-FUNDS TRNSF TO A/C XXXXXXXXXXXX",
            "amount": "100",
            "type": "Debit"
        },
        {
            "chequeNumber": null,
            "date": "2017-01-03T00:00:00",
            "description": "SI ACCOUNT TO ACCOUNT THIRD PA",
            "amount": "51",
            "type": "Debit"
        },
        {
            "chequeNumber": null,
            "date": "2017-01-05T00:00:00",
            "description": "CHARGE FOR OTC ECS TRAN",
            "amount": "220",
            "type": "Debit"
        },
        {
            "chequeNumber": null,
            "date": "2017-01-05T00:00:00",
            "description": "SI ACCOUNT TO ACCOUNT THIRD PA",
            "amount": "20",
            "type": "Debit"
        }
    ]
}

equity_jenga.api.account_services.inquiries¶

class equity_jenga.api.account_services.inquiries.AccountInquiry(authorization_token: str, merchant_code: str, env: str, private_key='/home/african/.JengaApi/keys/privatekey.pem', sandbox_url='https://sandbox.jengahq.io', live_url='', *args, **kwargs)[source]¶

Bases: auth.JengaAuth

account_details(countryCode, accountNumber)[source]¶

Example Response

{
    "account": {
        "number": "0011547896523",
        "branchCode": "017",
        "currency": "KES",
        "status": "Active"
    },
    "customer": [
        {
            "id": "100200300",
            "name": "A N.Other",
            "type": "Retail"
        }
    ]
}

authenticate(countryCode, accountNumber)[source]¶

equity_jenga.api.kyc¶

This web service enables your application to query the various registrar of persons in the various countries in East Africa.

Currently available for Kenya and Rwanda only.

https://sandbox.jengahq.io/customer-test/v2/identity/verify

class equity_jenga.api.kyc.IDSearchVerification(authorization_token: str, merchant_code: str, env: str, private_key='/home/african/.JengaApi/keys/privatekey.pem', sandbox_url='https://sandbox.jengahq.io', live_url='', *args, **kwargs)[source]¶

Bases: equity_jenga.api.auth.JengaAuth

authenticate(merchantCode, documentNumber, countryCode)[source]¶

Params

MerchantCode: Your MerchantCode
DocumentNumber: Document Number to Verify
CountryCode: The Country Code

Returns

Headers
Authorization: string the bearer token used to access the API
Content-Type: string the content type of the payload
Signature: string A SHA-256 signature to proof that this request is coming from the merchant. Build a String of concatenated values of the request fields with the following order: merchantcode documentNumber countryCode. The resulting text is then signed with Private Key and Base64 encoded.

Should return the headers to pass to the particular endpoint

verify(identity: dict)[source]¶

Params:

Identitiy

documentType: string the document type of the customer. for example ID, PASSPORT, ALIENID
firstName: string first name as per identity document type
lastName: string last name as per identity document type
dateOfBirth: string optional date in YYYY-MM-DD format
documentNumber: string the document id number
countryCode: string the country in which the document relates to (only KE and RW enabled for now)

Example Reponse

{
    "identity": {
        "customer": {
            "fullName": "John Doe ",
            "firstName": "John",
            "middlename": "",
            "lastName": "Doe",
            "ShortName": "John",
            "birthDate": "1900-01-01T00:00:00",
            "birthCityName": "",
            "deathDate": "",
            "gender": "",
            "faceImage": "/9j/4AAQSkZJRgABAAEAYABgA+H8qr6n4e1O71SGFbV/sEOF3O6/N/eb71d/FGkaBVXaq9KfRRRRRUMsKSIdyr0r/9k=",
            "occupation": "",
            "nationality": "Refugee"
        },
        "documentType": "ALIEN ID",
        "documentNumber": "654321",
        "documentSerialNumber": "100500425",
        "documentIssueDate": "2002-11-29T12:00:00",
        "documentExpirationDate": "2004-11-28T12:00:00",
        "IssuedBy": "REPUBLIC OF KENYA",
        "additionalIdentityDetails": [
            {
                "documentNumber": "",
                "documentType": "",
                "issuedBy": ""
            }
        ],
        "address": {
            "provinceName": " ",
            "districtName": "",
            "locationName": "",
            "subLocationName": "",
            "villageName": ""
        }
    }
}

equity_jenga.api.exceptions¶

Downstream Provider Error responses:

error	900101	Invalid merchant Cipher Text
error	900101	Invalid merchant certificate
error	900101	invalid merchant public key configuration – is empty
error	900101	Invalid merchant public key configuration —Public key is null
error	900101	Invalid merchant code provided

Merchant Authorization:

Status	Code	Response Message
error	401101	Unauthorized
error	401102	Service Not available
error	401103	Service Not available

Merchant Account/ Profile Validation:

error	104101	Validation of account failed
error	104102	Merchant daily transaction limit exceeded
error	104103	Insufficient Funds
error	104104	Invalid charge configuration
error	104105	Server Error
error	104106	Server error - could not save to database
error	104107	Invalid merchant configuration - No billing account found

RTGS:

error	118102	Service Not Available
error	118108	The source account has insufficient balance amount
error	103101	Invalid Account Type.
error	103102	Invalid account number .
error	103104	Insufficient funds.
error	103105	Transfer Limit Exceeded .
error	103106	Request Failed, please contact Bank.
error	103107	Invalid Currency/Transaction Amount.
error	103108	System Failure please retry .
error	103109	System malfunction .

Send Money - Within Equity Bank and Equitel

error	400103	Failed, invalid destination bank account
error	400104	Failed, insufficient funds
error	400105	Failed, general error
error	400106	Failed, destination bank error.
error	400107	Failed, destination bank error. Cut-over in progress
error	400108	Failed, destination bank error. System malfunction
error	400109	Failed, destination bank error. Duplicate transmission
error	400111	Failed, missing parameter in integration to gateway system
error	400112	Failed, could not process this request. System failure.
error	400101	Duplicate Transaction/ Payment Reference
error	400113	Failed, sender daily limit exceeded
error	103120	Failed, banking service could not process the request
error	400114	Failed, unable to process request. Third party is unavailable
error	400115	Failed, unhandled error
error	400116	Failed, 12 digit transaction reference required
error	118110	Failed, maximum transfer amount is 999,999 per transaction

Pesalink

error	100116	Failed, pesalink or destination bank error
error	100124	Failed, invalid amount
error	100128	Failed, pesalink or destination bank error
error	100130	Failed, pesalink or destination bank error
error	100134	Failed, amount less than minimum allowed
error	100207	Failed, destination cannot be found for routing
error	100209	Failed, pesalink or destination bank error
error	100210	Failed, transaction timed out
error	100211	Failed, pesalink or destination bank error
error	100232	Failed, banking service could not process the request
error	400101	Duplicate Transaction/ Payment Reference
error	100222	Failed, suspected fraud
error	400102	Failed, invalid destination bank account
error	400103	Failed, invalid destination bank account
error	400104	Failed, insufficient funds
error	400105	Failed, general error
error	400106	Failed, destination bank error.
error	400107	Failed, destination bank error. Cut-over in progress
error	400108	Failed, destination bank error. System malfunction
error	400109	Failed, destination bank error. Duplicate transmission
error	400110	Failed, bank not on pesalink
error	400111	Failed, missing parameter in integration to gateway system
error	400112	Failed, could not process this request. System failure.
error	400113	Failed, sender daily limit exceeded
error	400114	Failed, unable to process request. Third party is unavailable
error	400115	Failed, unhandled error
error	400116	Failed, 12 digit transaction reference required

Purchase Airtime

error	107101	Service Not available
error	107102	Invalid Provider
error	107103	Invalid Parameters
error	107104	Invalid Mobile Number
error	107105	Invalid Service Type
error	107106	Invalid Amount
error	107107	Payment reference Number should be 12 digits
error	107108	Authentication Failed
error	107109	The maximum amount allowed for transfers per transaction is KES 8000
error	107110	Failed. Transaction has been reversed to your Account {account}. Ref.{reference}.
error	107111	Dear Customer, we are unable to complete your request at this time. Kindly try again later. Reference Number {ref}
error	107112	Failed.Transaction Ref.#RefNo# unsuccessful. Kindly call 100 for assistance
error	400101	Duplicate Transaction/ Payment Reference

Send Money - To Mobile Wallet ( Airtel and M-PESA )

error	400101	Duplicate Transaction/ Payment Reference
error	400104	Failed, insufficient funds
error	400105	Failed, general error
error	400112	Failed, could not process this request. System failure.
error	400113	Failed, sender daily limit exceeded
error	400114	Failed, unable to process request. Third party is unavailable
error	400115	Failed, unhandled error
error	400116	Failed, 12 digit transaction reference required
error	103120	Failed, banking service could not process the request
error	105154	Failed, we cannot process your request at the moment due to system failure at Airtel
error	105156	Failed, the number is not registered for Airtel money
error	105157	Failed, credit party customer type can’t be supported by the service
error	105158	Failed, Maximum transfer amount is 70000 per transaction
error	105160	Failed, invalid mobile wallet
error	118101	Customer not registered for Equitel Mobile Banking

Bill and Till Payments

error	102101	Missing parameter
error	102102	invalid Reference Number
error	102103	Invalid Biller Code/Till Number
error	102104	Invalid Bill Reference
error	102105	Reversal Failed
error	102106	Insufficient Balance, Invalid Account
error	102107	System Failure please retry
error	102108	Reversal Failed
error	102110	Service Not available
error	400101	Duplicate Transaction/ Payment Reference

Eazzypay Push

error	114101	Merchant not registered for service
error	114102	Amount is below minimum that is allowed for transaction.
error	114103	The maximum amount limit is reached
error	114104	Customer is not registered
error	114105	Maximum daily amount per-day limit is reached for this payment
error	114106	Maximum transactions per-day limit is reached for this payment
error	114107	Invalid parameters. Kindly check with bank team
error	400101	Duplicate Transaction/ Payment Reference

Lipa na M-Pesa Online

error	117101	Bad Request - Invalid TransactionType
error	117101	Bad Request - Invalid Password
error	117101	Bad Request - Invalid PartyB
error	117101	Bad Request - Invalid CallBackURL
error	117101	Bad Request - Invalid Remarks
error	117101	Bad Request - Invalid PartyA
error	117101	Bad Request - Invalid Amount
error	117102	[MerchantValidate] - Wrong credentials
error	117102	Request failed: Output data invalid
error	117104	Error Occured: Spike Arrest Violation
error	500101	Generic error. Please contact our support.

Get Payment Status

error	111101	Failed. Invalid input parameters
error	111102	Bad request - Transaction not found.

Refund Payment

error	113101	Service Not available
error	113102	Invalid request format
error	113103	Invalid Transaction Status code for Reverse the Transaction
error	113104	Service Not available
error	113105	Due to technical problem we are not able to process your request

Identity Verification

error	115101	ID number used for search contains invalid symbols
error	115102	Serial number used for search contains invalid symbols
error	115103	At least one of search parameters should be filled
error	115104	Search can’t be done if one of mandatory fields is empty. All input parameters should be filled
error	115105	There is no record found in IPRS corresponding search parameters
error	115106	Service Not available
error	115107	Service Not available
error	115108	Service Not available
error	115109	Service Not available
error	115110	Service Not available
error	115111	Passport number contains illegal symbols
error	115112	At least one of search parameters should be filled
error	115113	Search can’t be done if one of mandatory fields is empty. All input parameters should be filled
error	115114	User can’t invoke verification methods because he didn’t pass the authorization or don’t have sufficient privileges
error	115115	Service Not available
error	115116	The image sent doesn’t correspond to the fingerprint format
error	115117	Service Not available
error	115118	Service Not available
error	115119	Service Not available

Account Balance

error

8504

No record could be retrieved

Create Bill

error	106101	Unauthorized
error	109101	invalid charge configuration
error	109102	invalid channel code
error	109103	Bill already cleared
error	109104	Invalid service configuration
error	109105	Invalid charge channel configuration code
error	109106	Invalid merchant Outlet code specified
error	109107	Invalid merchant code
error	109108	Invalid request data. Please check your payload
error	109109	Service not available

Credit & Debit Card

error	101101	Transaction could not be processed
error	101102	Transaction declined – contact issuing bank
error	101103	No reply from Processing Host
error	101104	Card has expired
error	101105	Insufficient credit
error	101106	Error Communicating with Bank
error	101107	Message Detail Error (Invalid PAN, Invalid Expiry Date)
error	101108	Transaction declined –transaction type not supported
error	101109	Bank Declined Transaction – Do Not Contact Bank
error	116101	Payment Not Updated
error	109101	invalid charge configuration
error	109102	invalid channel code
error	109103	Bill already cleared
error	109104	Invalid service configuration
error	109105	Invalid charge channel configuration code
error	109106	Invalid merchant Outlet code specified
error	109107	Invalid merchant code
error	109108	Invalid request data. Please check your payload
error	109109	Service not available

Receive Payments - Mobile Wallets

error	114101	Merchant not registered for service
error	114102	Amount is below minimum that is allowed for transaction.
error	114103	The maximum amount limit is reached
error	114104	Customer is not registered
error	114105	Maximum daily amount per-day limit is reached for this payment
error	114106	Maximum transactions per-day limit is reached for this payment
error	114107	Invalid parameters. Kindly check with bank team
error	111101	Failed. Invalid input parameters.
error	111102	Bad request - Transaction not found
error	116101	Payment Not Updated

Query Payment

error	112101	Amount paid is less or more than bill amount
error	112102	No transaction found for order ref
error	112103	Bill not found
error	112104	Invalid merchant code
error	112105	invalid service map configuration
error	112106	Due to technical problem we are not able to process your request
error	112107	Invalid service configuration
error	112108	Bill already cleared

Query Bill

error	110101	Invalid merchant code
error	110102	Invalid request data. Please check your payload
error	110103	bill doesn’t exist

Generic Error

{
"response_status": "error",
"response_code": "500101",
"response_msg": "Generic error. Please contact our support."
}

Target Error

200 OK

{
"response_status": "error",
"response_code": "{$.response code}",
"response_msg": "{$.message}"
}

equity_jenga.api.exceptions.handle_response(response)[source]¶: Handles Responses From the JengaHQ API and Raises Exceptions appropriately as errors occur and returns a dict object from the json response