IHELA OFFICIAL DOCS
  1. Agent Services
IHELA OFFICIAL DOCS
  • iHela Ryanje Official Docs
  • Merchant Services
    • Introduction
    • Basics
      • oAuth2 Authentication
      • Cashin Payment banks
      • Cashout Payment banks
      • Account Lookup
    • Bills Payment
      • Bills operations flow
      • Bills Init
      • Bill Status Check
      • Account Cashin
  • Banking Services
    • Introduction
    • Ping
      GET
    • Token Refresh
      POST
    • Token request
      POST
    • Account Lookup
      POST
    • Account Balance
      POST
    • Statement
      GET
    • Withdrawal
      POST
    • Deposit
      POST
    • Transaction Status
      POST
    • Transaction fees
      POST
  • Agent Services
    • Introduction
    • Ping
      GET
    • Token Refresh
      POST
    • Token request
      POST
    • Account Lookup
      POST
    • Deposit
      POST
    • Withdrawal Validation
      POST
    • Operation Lookup
      POST
    • Transaction Status
      POST
  1. Agent Services

Deposit

Testing
POST
/agent-deposit/
Last modified:2025-04-22 13:56:59
For Deposit Transactions.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
Authorization
string 
optional
Example:
Bearer {{ bank_switch_token}}
Body Params application/json
credit_account
string 
required
credit_account_holder
string 
required
amount
integer 
required
description
string 
required
pin_code
string 
required
Example
{
   "credit_account": "1413-01",
   "credit_account_holder":"NOBODY NOBODYME",
   "amount": 1000,
   "description": "Depot",
   "external_reference": "ref1201",
   "pin_code": "2025"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'http://127.0.0.1:8081/ihela/api/v1/agent-deposit/' \
--header 'Authorization: Bearer {{ bank_switch_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "credit_account": "1413-01",
   "credit_account_holder":"NOBODY NOBODYME",
   "amount": 1000,
   "description": "Depot",
   "external_reference": "ref1201",
   "pin_code": "2025"
}'

Responses

🟢200OK
application/json
Body
success
boolean 
optional
response_message
string 
optional
response_code
string 
optional
response_data
object 
optional
reference
string 
required
cbs_reference
string 
required
Example
{
    "success": true,
    "response_message": "Deposit successfully done to account/wallet 76001002",
    "response_code": "00",
    "response_data": {
        "reference": "15032369451027",
        "cbs_reference": "eCAD.3000100-816.3000101-2164",
        "external_reference": "ref120001"
    }
}
Modified at 2025-04-22 13:56:59
Previous
Account Lookup
Next
Withdrawal Validation
Built with