Transactions now include a category field which contains the insight about the transaction.
Transaction Object
{
"_id": "5f171a540295e231abca1154",
"type": "debit",
"narration": "TRANSFER from HASSAN ABDULHAMID TOMIWA to OGUNGBEFUN OLADUNNI KHADIJAH",
"amount": 10000,
"balance": 500,
"date": "2020-07-21T00:00:00.000Z",
"currency": "NGN",
"category": "transfer",
},
NOTE
Activation is based on request for now.
Please reach out to our Sales team via [email protected] to activate for your business.
Transaction Category Types
| Category | Type | Definition | API Format |
|---|---|---|---|
| Betting Payout | credit | All incoming transactions that are recognized as income from gambling. | betting_payout |
| Betting Deposit | debit | category for all outgoing transactions that are recognized as payments to gambling institutions. | betting_deposit |
| Bills | credit | All income transactions that are recognized as income from bills. Typically this category appears for self-employed private individuals that can issue a bill for their services. | bills |
| Cash Deposit | credit | All cash deposits at an ATM, Bank Counter etc. | cash_deposit |
| Cash withdrawal | debit | All outgoing transactions that are recognized as cash withdrawals at ATM machines. | cash_withdrawal |
| Cheque | debit | All outgoing transactions that are recognized as cheque withdrawals. | cheque |
| Cheque deposits | credit | Cheque deposit into account | cheque_deposits |
| Education | debit | All outgoing transactions related to education including high schools, universities, online courses, driving school, and similar. | education |
| Entertainment | debit | category for all expense transactions that are recognized entertainment, Netflix, and Apple Music. | entertainment |
| Bank Charges | debit | All outgoing transactions that are recognized as financial services and various commissions, for example, cash withdrawal commission, various card fees and similar. | bank_charges |
| Food | debit | category for all expense transactions that are recognized as food-related expenses. | food |
| Gifts and Donations | debit | All outgoing transactions made to flower shops, jewelry stores, photo shops, and private individual money transfers on birthdays. | gifts_donations |
| Groceries | debit | All transactions that are recognized as payments to grocery stores, hypermarkets, or supermarkets. | groceries |
| Health | debit | All outgoing transactions related to health including pharmacies, hospitals and similar. | health |
| Interest received | credit | All incoming transactions that are recognized as interest payments. Interest income is money earned by an individual or company for lending their funds, either by putting them into a deposit account in a bank | interest_received |
| Investment Payout | credit | All incoming transactions that are recognized as income from investments and currency trading. | investment_payout |
| Investment Deposit | debit | Transfers to related to investments, for example, transfers to investment platforms. | investment_deposit |
| Leisure activities, traveling | debit | category for all expense transactions that are recognized as leisure activities and traveling. | leisure_activities_traveling |
| Loans | credit | category for all incoming transactions that are recognized as Loans. eg Payable loans | loans |
| Loan Repayments | debit | category for all outgoing transactions that are recognized as Loans. eg Payable loans | loan_repayments |
| Other outgoing payments | debit | category for all outgoing transactions that do not hold enough information to be able categorize with greater granularity. | other_outgoing_payments |
| Online Payments | debit | Outgoing payments through online payment platforms, like Paypal, Chipper cash, flutterwave | online_payments |
| Other incoming payments | credit | category for all incoming transactions that do not hold enough information to be able categorise with greater granularity. | other_incoming_payments |
| Other incoming payments from employer | credit | All other incoming transactions from the employer that is not salary. For example, per diems or reimbursements. | other_incoming_payments_from_employer |
| Personal Care | debit | All outgoing transactions related to active lifestyle, for instance, gym membership, sportswear apparel, and sports nutrition, eden life | personal_care |
| Personal Transfer | credit/debit | category for all incoming transactions that are recognized as personal transfers. Personal transfers are defined as transfers that are received from or sent to a private individual. | personal_transfer |
| Phone & Internet | debit | All transactions that are recognized as payments for mobile phone plans, internet plans | phone_internet |
| Rent and maintenance | debit | All transactions that are recognized as utility payments for rent and maintenance, property management | rent_maintanence |
| Returned debit | credit | All income transactions that are return of funds to a private individual (consumer), forcibly initiated by the issuing bank of the instrument used by a consumer to settle a debt. | returned_debit |
| Salary | credit | All incoming transactions that are recognized as salary payments from an employer. Typically these transactions occur with some time period regularity, for example, on monthly or weekly or other time period regularity basis | salary |
| Savings | debit | Transfers related to savings, for example, transfers to savings accounts. | savings |
| Transport | debit | category for all expense transactions that are recognized transportation-related expenses. | transport |
| Utility Services | debit | category for all expense transactions that are recognized as Utility services. Usually, these transactions occur with some time period regularity, for example, on monthly basis. Light, water, gas etc. | utility_services |
| Unknown | credit/debit | All unrecognised transactions | unknown |