​

Balance Inquiry

• Check available payout balance
• Validate wallet funds before initiating payouts
• Monitor payout account liquidity
• Prevent insufficient balance payout failures

​

Endpoint

POST /api/v3/payout/balance

​

To view all available base URLs and environments, refer to:

​

Authentication required.

​

Request Body

{
  "kwikx_wallet_id": "4646464445"
}

​

Example cURL Request

curl --request POST \
--url https://sandbox.Elite Neo Bank.com/api/v3/payout/balance \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "X-API-KEY: pk_test_xxxxxxxxx" \
--header "X-SIGNATURE: GENERATED_SIGNATURE" \
--header "X-TIMESTAMP: GENERATED_TIMESTAMP" \
--data '{
"kwikx_wallet_id": "4646464445"
}'

​

Example Success Response

{
  "status": true,
  "code": 200,
  "message": "Wallet balance fetched successfully.",
  "data": {
    "environment": "sandbox",
    "wallet_id": "6116229263036",
    "currency": "INR",
    "balance": "99990.00",
    "ip_status": "approved",
    "profile_status": "under_review",
    "account_status": "under_review"
  }
}

​

Response Parameters

​

Recommended Use Cases

• Validate payout wallet balance
• Check available funds before payouts
• Monitor operational liquidity
• Prevent payout failures due to insufficient funds

​

Important Notes

• Balance is returned in real-time
• Currency is currently supported in INR
• Insufficient balance may prevent payout initiation
• Always validate balance before bulk payout processing

​

Recommended Workflow

1. Check wallet balance
2. Validate available funds
3. Initiate payout transaction
4. Verify payout status using Payout Status API

​

Common Errors

​

401 Unauthorized

• Invalid API key
• Incorrect signature
• Expired timestamp

​

403 Access Denied

• Merchant not authorized for payouts
• Payout services disabled

​

Security Recommendations

• Generate signatures server-side only
• Never expose secret keys publicly
• Use HTTPS for all requests
• Validate API responses before processing payouts

​

Best Practices

• Check balance before every payout batch
• Monitor payout wallet regularly
• Maintain sufficient operational balance
• Implement low-balance alerting systems