P2P Accounts Wallet Balance

To retrieve wallet balance details, send a POST request to the following endpoint:

POST https://<domain>/api/wallet_balance.php

Send a POST request with the following JSON structure in the request body:

Headers

Name	Value
Content-Type	application/json
Authorization	<token>

Body

Name	Type	Description
email	string	Your registered email ID.
verification_code	string	MD5 hash of the operator's password.

Sample Request

Request Body

{
    "email": "[e-mail]",
    "verification_code": "hg66576fca53eakjkjk76762c4"
}

Sample Response

Upon a successful request, the response will return wallet balance details in the following JSON format:

200

{
"status": "success",
"operator_details": {
    "name": "Name",
    "email": "[e-mail]"
},
"wallets": {
    "upi": [
        {
            "account": "SanoojAccount",
            "upi": "sample@uoi",
            "minimum_balance": "0",
            "limit_volume": "0",
            "usage_volume": "0"
        },
        {
            "account": "SanoojAccount1",
            "upi": "sample1@uoi",
            "minimum_balance": "1000",
            "limit_volume": "10000",
            "usage_volume": "100000"
        }
        ],
        "imps_upi":[
        {
            "account_holder":"HareeshMenon",
            "account_number":"34343432323232",
            "bank":"hdfc",
            "minimum_balance": "0",
            "limit_volume": "0",
            "usage_volume": "0"
        },
        {
            "account_holder":"HareeshMenon1",
            "Account_number":"342434334343",
            "bank":"hdfc",
            "minimum_balance": "500",
            "limit_volume": "10000",
            "usage_volume": "4000"
        }]
        }
}

400

//Error Response Example: If the request is invalid or fails, the response may look like this:
{
    "status": "error",
    "message": "Invalid verification code or email."
}

Explanation of Response Fields:

1. status: Indicates the status of the request. Expected value: success.

2. operator_details:

   • name: Name of the operator managing the account.

   • email: Registered email of the operator.

3. wallets: Contains details of the wallets linked to the account.

   • upi: List of UPI wallets.

     • account: Name of the UPI account.

     • upi: UPI ID associated with the account.

     • minimum_balance: Minimum balance required in the wallet.

     • limit_volume: Maximum transaction limit available.

     • usage_volume: Volume of transactions already used.

   • imps_upi: List of IMPS & UPI accounts linked.

     • account_holder: Name of the account holder.

     • account_number: Account number for the IMPS account.

     • bank: Bank name.

     • minimum_balance, limit_volume, and usage_volume work similarly to UPI wallets.

Integration Notes:

• Ensure you are using the correct token, email, and verification code to avoid authorization issues.

• The API endpoint is secured with HTTPS and requires proper authentication through the provided verification code.

• Handle success and error responses appropriately in your application for an improved user experience.