Vantaca Pay provides management companies with a streamlined process for issuing homeowner payment refunds directly from the Community Management Platform (CMP). This self-service capability eliminates the need to submit support tickets for routine refund requests, allowing authorized management company employees to process refunds efficiently while maintaining proper security controls.
Important: This functionality is only available for associations using Vantaca Pay and requires specific security permissions to access the refund features.
Contents
Understanding Vantaca Pay Refunds
The Vantaca Pay refund system allows authorized management company employees to issue refunds for homeowner payments directly from the homeowner ledger. When you process a refund through Vantaca Pay, the system automatically works with the payment integration to issue the refund and updates the homeowner's ledger accordingly.
Key Benefits:
- Self-service refund processing without support tickets
- Secure permission-based access controls
- Automatic ledger updates and transaction recording
- Real-time refund processing
Required Permissions
To process Vantaca Pay refunds, you must have the Homeowner Ledger Advanced Adjustment security role permission assigned to your role. This existing permission now provides access to the new refund functionality.
To add the permission:
-
Navigate to Settings > Roles.
The Roles page displays. -
Search for the role that you want to allow to process Vantaca Pay refunds.
For example, in the following image, the user wants to allow Administrators to use this feature and enters admin in the search field to display all roles that include the word "admin".
- Click the caret next to the role name to open it (ensure the Security tab is selected).
-
Go to the Homeowner section and click Edit next to Homeowner Ledger.
The Edit Role Security screen opens.
- Select all of the security permissions (including Vantaca Pay Refund).
- Click Save changes.
Note: The Refund column and button only appear for homeowners in associations that use Vantaca Pay. If you do not see the refund options, verify that:
- Your association is set up to use Vantaca Pay
- You have the required security permissions
- The payment was processed through Vantaca Pay
Process a Homeowner Refund
To issue a refund for a homeowner's Vantaca Pay payment:
- Navigate to Homeowners > Homeowner Profile > Ledger.
- Ensure that the correct homeowner displays at the top of the screen, or click the name to open the Search screen where you can search and select the appropriate homeowner.
- Click the Transactions tab and locate the specific Vantaca Pay payment you want to refund.
- In the Actions column, click Refund for the payment.
The Refund Payment modal opens that displays the homeowner name and refund amount.
- Click Submit to process the refund.
The system sends the refund request to the payment integration and begins the automated refund workflow (see next section for more information about the workflow).
Refund Workflow
When you submit a refund through Vantaca Pay, the system follows this automated workflow:
- Refund Request Validation: The system validates the refund amount against the original payment to ensure it does not exceed the paid amount.
- Integration Processing: A refund request is automatically sent to the payment integraton with the payment details, account information, refund amount, and association data.
- Ledger Updates: The system automatically creates a Bank Return action item and voids the original payment in the homeowner's ledger.
- Transaction Recording: All refund activity is recorded in the homeowner's transaction history for audit and tracking purposes.
Note: The refund process typically completes within a few minutes, but the actual time for funds to appear in the homeowner's account depends on their bank and the original payment method used.
Troubleshooting
Q: I don't see a Refund button next to any payment. Why?
A: The Refund button only appears for payments that were processed through Vantaca Pay. Check that:
- The payment was made using Vantaca Pay (not other payment methods)
- The payment has a Paid status
- The payment has not already been refunded
Q: I receive an error when trying to process a refund. What does this mean?
A: The system validates refund amounts to ensure they don't exceed the original payment. This error occurs when:
- The refund amount is greater than the original payment amount
- The payment has already been partially refunded and the new amount would exceed the remaining balance
Q: I submitted a refund, but it doesn't appear to be processing. What should I do?
A: If a refund appears stuck or fails to process:
- Wait 5-10 minutes, as processing may take time
- Check the homeowner's ledger for any error messages or status updates
- Verify the original payment is still in a Paid status
- Contact Vantaca Support if the issue persists after 30 minutes
Q: I get a permission error when trying to access the refund functionality. How do I resolve this?
A: Permission errors indicate insufficient security access. Contact your system administrator to:
- Verify you have the Homeowner > Homeowner Ledger Advanced Adjustment permission
- Confirm your user role includes refund processing capabilities
- Check that your association is properly configured for Vantaca Pay
Note: For issues not covered in this troubleshooting section, contact Vantaca Support with the homeowner's account information, payment details, and a description of the problem.
Comments
0 comments
Please sign in to leave a comment.