logo
English
English
API ReferenceSign In

Rules and Limitations

Last updated 09/19/2019

Payment Amount

The following is a table of guidelines for payment nominal limitations:

Bank NameMinimum Payment Amount (IDR)Maximum Payment Amount (IDR)
BNI, BNI Syariah, BRI, BSS, and Mandiri150,000,000,000
Permata19,999,999,999
BCA10,000999,999,999,999

Please be informed that there are maximum limitations for payments via ATM, M-Banking, and Internet Banking where each bank has different policies. Some banks limit it to IDR 25,000,000.

Payment Amount Display 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.

Bank NameFrom the Same BankFrom Interbank
BCA, BNI, BNI Syariah, MandiriThe expected amount will be displayedThe expected amount is not displayed, customers can enter a different amount than the set amount
BRI, BSS, CIMB, PermataThe 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

Transaction Time

Transactions on a Virtual Account can be made at any time while the Virtual Account is in 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.

Settlement Time

The settlement time for Virtual Account transactions will depend on the commercial model you choose. The following is an explanation of the cooperation model and its relation to settlement time:

Commercial ModelSettlement Time
AggregatorInstant
SwitcherD+1

Note: For BCA aggregators, the transaction will be settled in D + 2 working days after the transaction date. Please see Virtual Account Page for full details about our commercial model.

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 Digit (Character)Maksimum Digit (Character)
BCA (Aggregator Model)350
BCA (Switcher Model)330
BNI, BNI Syariah, BSS1100
BRI, Mandiri, Permata120
CIMB1200

Display Name

The following is a list of banks that can display your business name when customers make payments at ATMs and Mobile / Internet Banking.

Bank NameDisplay Name
BCA, BNI, BNI Syariah, and BRIYour business name or the name of your customer that will appear when the customer is about to make a payment
BSS, CIMB, Mandiri, and PermataXendit name that will appear when the customer is about to make a payment

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 xenInvoice is 24 hours.

Virtual Account Cancellation

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?
Yes No