Skip to main content

Rules dan 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 NameFrom the Same BankFrom Interbank
BCA, BNI, BSI, BRI, BJB, CIMB, Mandiri, and PermataThe expected amount will be displayedThe expected amount is not displayed, customers can enter a different amount than the set amount
BSSThe expected amount is not displayed, customers can enter a different amount than the set amountThe 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.

StatusDefinition
DetectedPayment callback has been received by Xendit but the money is not settled yet and unavailable for the customer to withdraw
CompletedPayment callback has been received by Xendit and the money has been settled and available for the customer to withdraw

VA Name Restriction

  1. Name cannot contain names from banks/institution/governments.
  2. 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.
  3. 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 NameMinimum CharacterMaximum Character
BCA (Aggregator Model)350
BCA (Switcher Model), BSI330
BNI, BSS1100
BRI, Mandiri, Permata120
BJB1255
CIMB1200
DBS170

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.

Was this page helpful?