Rules and Limitations
Payment Amount Displayed on Close-Amount
For a Virtual Account with a close-amount, the Virtual Account will only receive payments according to the expected amount. However, in practice, there is still a possibility that your customer can pay the Virtual Account with a nominal other than the expected nominal. The following is a table of guidelines for payments on a Virtual Account with a close amount. Please note that this is only applied to the aggregator model only.
| Bank Name | From the Same Bank | From Interbank |
|---|---|---|
| BCA, BNI, BSI, BRI, BJB, CIMB, Mandiri, and Permata | The expected amount will be displayed | The expected amount is not displayed, customers can enter a different amount than the set amount |
| BSS and BNC | The expected amount is not displayed, customers can enter a different amount than the set amount | The expected amount is not displayed, customers can enter a different amount than the set amount |
For DBS, the expected amount is always not displayed because the payment tool is Telegraphic Transfer, therefore customers can enter a different amount than the set amount.
Transaction Time
Transactions on a Virtual Account can be made at any time while the Virtual Account is active status. However, if your customer pays using a different bank (i.e. interbank transfer), the sending bank may wait to continue the transaction until the next business hour.
As long as the sending bank of your customer is able to transact and send money to the receiving bank, Xendit will receive a notification (callback) from the receiving bank and process the transaction on our system.
Payment Status in the Dashboard
Below is the definition for the possible status for Virtual Account payment in the dashboard.
| Status | Definition |
|---|---|
| Detected | Payment callback has been received by Xendit but the money is not settled yet and unavailable for the customer to withdraw |
| Completed | Payment callback has been received by Xendit and the money has been settled and available for the customer to withdraw |
VA Name Restriction
- Name cannot contain names from banks/institution/governments.
- Name cannot be updated or changed. If you urgently need to change the Virtual Account name, you can reach us at help@xendit.co and we will be happy to help you.
- For Individual account type, VA name is not customizable and will always follow your business name.
VA Name Length
Bank has a limit for the length of the name which results in the Virtual Account name being truncated if the name exceeds the maximum character when your customer makes a payment. The following is a table of guidelines for character lengths in Virtual Account names:
| Bank Name | Minimum Character | Maximum Character |
|---|---|---|
| BCA (Aggregator Model) | 3 | 50 |
| BCA (Switcher Model), BSI | 3 | 30 |
| BNI, BSS | 1 | 100 |
| BRI, Mandiri, Permata | 1 | 20 |
| BJB | 1 | 255 |
| CIMB | 1 | 200 |
| DBS | 1 | 70 |
| BNC | 1 | 18 |
| MSB Bank, PV Bank, Vietcapital, and Woori | 1 | 47 |
Expiration Time
The expiration date is the date that a Virtual Account becomes inactive and cannot receive any more payments. Payments made after the Virtual Account has expired will be automatically rejected. Please be informed that Fixed Virtual Account will have 31 years as default expiration time, but you can set it when creating a Virtual Account via API (Please visit virtual account API reference). The default expiration time for Virtual Accounts on Payment link is 24 hours.
Cancelling Virtual Account
We currently do not provide a feature that can delete or cancel a Virtual Account. If you need to stop using a certain Virtual Account, we recommend that you update the expiration time to a past time so that the Virtual Account will expire and become inactive.
Last Updated on 2023-07-23