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

Token request

Testing
POST
/auth-token/
Last modified:2025-04-14 09:06:26
used to request a token, which will be used to authenticate the user.
All of the following requests must contain two headers:
"Accept: application/json"
"Authorization: Bearer access”.
Two tokens will be generated, an access token and a refresh token, when the access token is no longer valid, the user will have to request another one by using the refresh token API with the value of the refresh token in the request body.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
username
string 
required
password
string 
required
Example
{
    "username":"USERNAME",
    "password":"PASSWORD"
}

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/auth-token/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username":"USERNAME",
    "password":"PASSWORD"
}'

Responses

🟢200OK
application/json
Body
refresh
string 
optional
access
string 
optional
Example
{
    "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBjkoIO098n4cCI6MTY3OTU2NDEwMywianRpIjoiYzlkODRhNmJiYWFkNGFjNjhkN2NmNjgwMDVhMTc5YTciLCJ1c2VyX2lkIjo0fQ.1ITZeRD1mj4uyv4gl_cyzJc7tCrJPKv9Ce0S-gtqfx4",
    "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjc5NTY0MTAzLCJqdGkiOiJhODc2NmVhMjIxMjc0OGRmOTQ2NjM1NTJiMjFiM2hu_GY7868UQoJK6fFaVbeCZF9oB-tJ-RGDaw8"
}
Modified at 2025-04-14 09:06:26
Previous
Token Refresh
Next
Account Lookup
Built with