Overview#
Virtual Account Payout enables businesses to transfer funds seamlessly from virtual accounts to beneficiaries using various payment modes such as NEFT, IMPS, RTGS, and UPI. This documentation provides a detailed guide on integrating with the Axis Payout API to initiate and manage transfers from virtual accounts.Key Features#
Multi-Mode Transfers: Supports NEFT, IMPS, RTGS, and UPI.
Beneficiary Management: Easily add, retrieve, and remove beneficiaries.
Bank Account Validation: Ensures correct beneficiary details before initiating payments.
Webhook Support: Receive real-time updates on payout status.
Detailed Reports: Retrieve payout and transaction history.
Use Cases#
Payroll Management: Automate salary disbursements to employees.
Vendor Payments: Pay suppliers and service providers instantly.
Refund Processing: Issue refunds to customers efficiently.
Financial Services: Enable quick fund transfers for fintech applications.
Life Cycle of a Transfer from a Virtual Account#
A transfer from a virtual account follows these statuses:Initiated#
Transfer is added to the queue but not yet sent to the bank. Money has been debited but not yet credited to the beneficiary. Applies only to asynchronous transfers.Pending#
The transfer request has been sent to the bank for processing.Failed#
The transfer could not be processed, and money has been reversed to the debit account.Integration Flow for Transfers from Virtual Accounts#
Step 1: Add a Beneficiary#
Before initiating a transfer, add the recipient as a beneficiary using the Beneficiary API. Indiconnect supports two types of beneficiaries:Bank Account Beneficiaries
VPA ( Payment Address) Beneficiaries
Step 2: Create a Transfer#
Once the beneficiary is added, initiate a transfer using the Create Transfer API.Transfer Modes, Limits, and Timings#
Note: NEFT/RTGS working days exclude 2nd and 4th Saturdays, Sundays, and bank holidays.Use Case: Payroll Management#
1. Scenario#
Businesses need to automate salary disbursements to employees on a scheduled basis.
Salaries should be transferred instantly to employees' bank accounts via NEFT, IMPS, RTGS, or UPI.
The system must ensure error-free and timely salary payments.
2. Workflow#
Fund Payroll Account: The company loads funds into a virtual payroll account before salary processing.
Add Employees as Beneficiaries: Employee bank details are added as beneficiaries using the Beneficiary API.
Automate Salary Disbursement: Salaries are transferred to employee bank accounts using bulk payouts with NEFT, IMPS, or RTGS.
Generate Reports: Employers retrieve salary disbursement reports for reconciliation and compliance.
Error Handling#
200 OK: Request successful
400 Bad Request: Invalid request parameters
401 Unauthorized: Invalid API key
404 Not Found: Resource not available
500 Internal Server Error: Temporary server issue
Troubleshooting Tips#
Ensure API keys are correctly passed in the request headers.
Validate beneficiary details before initiating a payout.
Verify the payout mode (NEFT, IMPS, RTGS, UPI) is supported by the recipient’s bank.
FAQs#
Q1: What is a virtual account?#
A virtual account is a digital account used exclusively for online transactions, without physical checkbooks or debit cards.Q2: How do I add a beneficiary?#
Use the Beneficiary API to add a new beneficiary by providing their bank account or VPA details.Q3: Are there any transfer limits?#
Yes, transfer limits depend on the payment mode. Refer to the Transfer Modes, Limits, and Timings section for details.Q4: How long does a payout take?#
Q5: Can I cancel a payout?#
No you can’t cancel the payout once initiated.Support#
Final Notes#
The Virtual account Payout API simplifies disbursements by providing secure, automated, and efficient fund transfers. Virtual account-based payout services enhance transparency and traceability, streamlining financial operations for businesses.Modified at 2025-07-11 05:14:40
