Static Virtual Account

Overview

A Static Virtual Account (SVA) is a reusable virtual account number assigned to a customer that can be used for multiple payments. Unlike per-transaction VAs, a static VA stays the same for that customer and can be used repeatedly, which is useful for repeat buyers, subscription-like flows, or recurring collections without API integration.

Create SVA

Requirements

• VA payment method(s) enabled for your account

• Customers added to your customers database (refer to Manage Customers)

• Billing type configured for the bank(s) you will be using

  • FIX BILL is for closed amount VA

  • NO BILL is for open amount VA

• Suffix features must be activated for the bank(s) and billing type(s) you will be using

  • DOKU Generated Payment Code (DGPC) for auto-generated suffix

  • Merchant Generated Payment Code (MGPC) for phone number and reference ID suffix

Single-Customer SVA

You can create a static VA for a single customer by following the steps below:

1. Log in to DOKU Dashboard, and then access the side navigation bar

2. Select Customers from the menu

3. On the Customers page, find the customer you want to create a VA for

4. Click the ellipsis ( ⋮ ) icon on the far right of that customer row, then select Create Virtual Account

   
5. Select Amount Type:

   1. Closed Amount: Amount is decided by the merchant, and is set when creating SVA Payment Link (refer to Create SVA Payment Link)

   2. Open Amount: Amount is decided by the customers at payment time

6. After choosing amount type, select the bank for the VA (available banks are listed based on your account’s VA settings)

7. Select VA suffix customization:

   1. Auto-generated: DOKU generates a random suffix

   2. Reference ID: Suffix generated from the customer’s Reference ID

   3. Phone Number: Suffix generated from the customer’s phone number

1. Check the preview to confirm the selected bank, virtual account number, and suffix

   
2. Click Create Virtual Account.

On success, a confirmation pop-up appears. Open the customer details to confirm the SVA is created and visible on their profile.

Bulk-Customer SVA

You can create a static VA for multiple customers by following the steps below:

1. Log in to DOKU Dashboard, and then access the side navigation bar

2. Select Customers from the menu

3. On the Customers page, select the checkboxes for the customers you want to create SVAs for

   
4. Click Action, then select Create Virtual Account

5. Select Amount Type:

   1. Closed Amount: Amount is decided by the merchant, and is set when creating SVA Payment Link (refer to Create SVA Payment Link)

   2. Open Amount: Amount is decided by the customers at payment time

6. After choosing amount type, select the bank for the VA (available banks are listed based on your account’s VA settings)

7. Select VA suffix customization:

   1. Auto-generated: DOKU generates a random suffix

   2. Reference ID: Suffix generated from the customer’s Reference ID

   3. Phone Number: Suffix generated from the customer’s phone number

   

1. Review the list of selected customers shown in the dialog

   • If you selected Reference ID or Phone Number, ensure every customer in this list has the required value. If a customer is missing the value, remove them from the list before proceeding

1. Confirm the preview of chosen bank, VA format, and suffix customization

1. Click Create Virtual Account.

On success, a confirmation pop-up appears. Open the details of each customer to confirm the SVA is created and visible on their profile if needed.

Create SVA Payment Link

SVA payment links are used for closed amount SVAs (where the merchant defines the amount). There are two flows: Single Link (1 customer) and Bulk Links (multiple customers).

Single Link

You can generate an SVA Payment Link via DOKU Dashboard by following the steps below:

1. Log in to your DOKU Dashboard, and then access the side navigation bar

2. Navigate to Accept Payments > Payment Link

3. Click Create Payment Link

4. On Create Payment Link page, select the Payment with Static Virtual Account shortcut. If the shortcut isn't visible, do this manually:

   • Under Customer Details, toggle Select Customer on and choose the customer who has a static virtual account

   • Under Payment Details, tick Use Customer Virtual Account and choose the bank of that customer’s static VA

   
5. Fill in Order Details:

   • For "Payment Description", fill in total payment and description

   • For "Add Item", fill in item name, quantity, and price

   
6. Click Create Payment Link.

You can share the generated link with the customer. If email notifications are enabled, the customer will receive an email with their static VA number and the payable amount.

Bulk Links

You can generate bulk SVA Payment Links via DOKU Dashboard by following the steps below:

1. Log in to DOKU Dashboard, and then access the side navigation bar

2. Select Customers from the menu

3. On Customers page, select the customers you want to create bulk SVA payment links for and click Action > Download Bulk Payment Link Template

   
4. Choose a template:

   1. Amount & Description Only: only total payment and description required

   2. Include Product Information: include item name, quantity, and price

   
5. Click Download and complete the template with the required information for each customer

   
6. After completing the file, upload it back to the dashboard:

   • If the upload window is still open, click Upload to proceed

   • If you exited the page, go to Accept Payments > Payment Link > Bulk Payment Link tab, then click Import XLSX and upload the completed file

7. Click Import to generate bulk SVA payment links.

   

Once the import is complete, you can share the generated links with customers. If email notifications are enabled, customers will automatically receive an email containing their Static VA number and the payment amount.

FAQ