API Reference
DOKU DocsChangelogDOKU Github
  • Getting Started with DOKU API
    • User Registration
    • Idempotency Request
    • Notification
      • Setup Notification URL
      • HTTP Notification Sample for SNAP
      • HTTP Notification Sample - Non SNAP
      • Best Practice
      • Retry Notification
      • Override Notification URL
    • Signature Component
      • Non-SNAP
        • Signature Component from Request Header
        • Signature Componen from Response Header
        • Signature from API Get Method
        • Sample Code
      • SNAP
        • Symmetric Signature
        • Asymmetric Signature
    • Response Code
      • HTTP Status and Case Code
    • Check Status API
      • Non-SNAP
      • SNAP
    • Retrieve Payment Credential
  • Accept Payment
    • DOKU Checkout
      • Integration Guide
        • Backend Integration
        • Frontend Integration
        • Simulate payment and Notification
      • Supported Payment Methods
      • Status Order
      • Additional Feature
        • Tokenization
        • Promo on DOKU Checkout Page
        • Track Campaign Source on Google Analytics
      • Checkout Settings
    • Direct API
      • Non-SNAP
        • Cards
          • Payment Page Integration Guide
          • Host-To-Host Integration Guide
          • Mastercard Automatic Billing Updater (ABU) Integration Guide
            • Backend Integration
        • e-Wallet
          • Overview
          • DOKU e-Wallet
          • OVO Push Payment
          • ShopeePay
          • LinkAja
        • Paylater
          • Akulaku
          • Kredivo
          • Indodana
        • Digital Banking
          • Jenius Pay
        • Convenience Store
          • Alfa Group
          • Indomaret
      • SNAP
        • Integration Guide
          • Get Token API
            • B2B
            • B2B2C
          • Virtual Account
            • CIMB Virtual Account
            • BSI Virtual Account
            • BCA Virtual Account
            • BNC Virtual Account
            • BNI Virtual Account
            • Mandiri Virtual Account
            • BRI Virtual Account
            • BTN Virtual Account
            • Permata Virtual Account
            • Danamon Virtual Account
            • BSS Virtual Account
          • E-Wallet
            • DOKU Wallet
            • DANA
            • OVO
            • ShopeePay
          • Direct Debit
            • Allo Bank Direct Debit
            • BRI Direct Debit
            • CIMB Direct Debit
            • Mandiri Direct Debit
          • Kartu Kredit Indonesia Cepat Secure(KKI CPTS)
            • Host to Host Integration
          • QRIS
    • Finance and Settlement
      • Split Settlement
      • Custom Settlement Report
      • Hold and Release Settlement
      • Bulk Registration Bank
    • Test on DOKU Demo Site
    • DOKU Payment Simulator
  • Developer Kit
    • Postman Collection
    • Libraries and SDK
  • Wallet As A Service
    • Sub Account
  • Partnership
    • Partner API
      • Check Requirements API
      • Generate Token API
      • Upload File API
      • Business Registration API
      • Create Business Lite API
      • Get Business Data API
  • Payout
    • Kirim DOKU
  • FLEXIBILL
    • Account Billing
      • Batch Upload
    • DOKU Biller
      • Response Code
      • Samples
  • PAYCHAT API
    • Send WhatsApp Message
  • Archive
    • Non-SNAP
      • Tokenization V1
      • e-Wallet
        • OVO Recurring
        • OVO Open API
    • SNAP
      • Virtual Account
        • BCA v1.0
        • BRI v1.0
        • BNI v1.0
        • BNC v1.0
        • Mandiri v1.0
        • BTN v1.0
        • Permata v1.0
        • Danamon Virtual Account
      • e-Wallet
        • OVO Open API
        • DANA
        • ShopeePay
      • Direct Debit
        • CIMB Direct Debit
        • BRI Direct Debit
        • Allobank
Powered by GitBook

DOKU API

  • Legacy Documentation
On this page
  • Features for Virtual Account
  • Billing Type
  • BIN Rules
  • Reusable Status
  • What's next?

Was this helpful?

  1. Accept Payment
  2. Direct API
  3. SNAP
  4. Integration Guide

Virtual Account

DOKU provides various payment channels. One of the most used by our merchants is Virtual Account. By using this payment channels, your customer can pay their order through bank transfer and DOKU will notify you once the payment is completed by your customer. DOKU has partnered with various banks to help you provide many payment options for your customers.

Features for Virtual Account

Virtual Account Number Component

Virtual Account number which is displayed to customer, contains two parts. The first part is the company code (BIN) and the second part is unique VA Number.

There are 2 types of general features that can be used with Virtual Accounts :

  1. Register : The VA number will be registered to DOKU and Acquirer will inquiry to our side when the customer make payment at the acquirer channel (ATM, mobile banking, internet banking, etc.)

Feature Type
Description

DOKU Generated Payment Code ( DGPC )

Merchants don’t need to generate payment code, just need to request from DOKU and DOKU will send a unique payment code. Component VA Number : BIN and Unique VA Number. Suitable for e-commerce business model.

Merchant Generated Payment Code ( MGPC )

Merchants can generate payment codes with their own rules, and send the code to DOKU and customers will use it for payment. Component VA Number : BIN and Unique VA Number. Suitable for top up business model.

  1. Direct Inquiry ( DIPC ) : The VA number is registered on merchant side and DOKU will forward Acquirer inquiry request to merchant side when the customer make payment at the acquirer channel (ATM, mobile banking, internet banking, etc.). Component VA Number : BIN and Unique VA Number.

ONE TRANSACTION CAN'T USE 2 OR 3 FEATURES AT THE SAME TIME.

By default, DOKU will register your business with Doku Generate Payment Code feature which means BIN for VA will be generated by DOKU side. But there is no limit for you to be able to use 2 features at the same time. What it can't do is that 1 transaction uses 2 features at the same time.

GET THE BIN

If you want to use MGPC or DIPC, then please contact the care team to get a BIN as a component for the VA Number.

Billing Type

Billing type is a type of feature used by merchants to determine the method of payment for their customers when they are in Inquiry. In case, the customer can input the amount according to their expected amount or the customer can also pay according to the amount that has been determined by the merchant.

Here is a billing type and their defenition that can be implemented into virtual account transactions.

Billing Type
Description

Customer can only pay the bill with the amount stated in the bill (Closed Amount / Full Payment).

Customer can pay with their amount and Virtual Account can accept payments for any nominal value.

Customer can pay according to the amount they want or randomly in a predetermined range.

Applicable for Channel

For your information, each acquirer has its own rules. There is an Acquirer that doesn't support billing type. Here's the checklist :

Bank Name
Fix Bill
No Bill
Bill Variable Amount

BCA

✅

✅

✅

Mandiri

✅

✅

❌

BSI

✅

❌

❌

DOKU

✅

✅

❌

BRI

✅

✅

❌

CIMB

✅

✅

❌

Permata

✅

✅

❌

Danamon

✅

✅

❌

BNI Only

BNI have a special rules, billing type for BNI are OPEN, FIXED, INSTALLMENT, MIN, OPEN MIN and OPEN MAX. You can see the detail, in BNI Section.

BIN Rules

In accordance with the explanation regarding the Virtual Account Component, BIN is one of the components to create a virtual account. So, here's an explanation regarding BIN rules and adapt them to your needs.

Note

These rules only apply to Aggregator Partnership Models, which means merchants use DOKU's BIN.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (8 digit) + DOKU Generated Payment Code (8 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 9 digit) + Free Digit (max. 7 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (5 digit) + Free Digit (max. 11 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 16 digit.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (6 digit) + DOKU Generated Payment Code (10 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 9 digit) + Free Digit (max. 9 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (5 digit) + Free Digit (max. 13 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 18 digit

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (5 digit) + DOKU Generated Payment Code (11 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 6 digit) + Free Digit (max. 10 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (5 digit) + Free Digit (max. 11 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 16 digit.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (6 digit) + DOKU Generated Payment Code (10 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 9 digit) + Free Digit (max. 14 digit)

Merchant Generate Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (5 digit) + Free Digit (max. 18 digit)

Merchant Generate Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 23 digit.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (6 digit) + DOKU Generated Payment Code (10 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 9 digit) + Free Digit (max. 7 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (5 digit) + Free Digit (max. 11 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 16 digit.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (6 digit) + DOKU Generated Payment Code (10 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 9 digit) + Free Digit (max. 9 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (5 digit) + Free Digit (max. 13 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 18 digit.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (7 digit) + DOKU Generated Payment Code (9 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 4 digit) + Free Digit (max. 12 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 16 digit.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (5 digit) + DOKU Generated Payment Code (11 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 8 digit) + Free Digit (max. 8 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (4 digit) + Free Digit (max. 12 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Maximum virtual account number is 16 digit.

Partnership Model
BIN Type
Description
VA Number Component
Feature

Aggregator

DOKU General

DOKU's BIN in Acquirer, that DOKU provide for merchants to use

DOKU General BIN (5 digit) + DOKU Generated Payment Code (11 digit)

DOKU Generated Payment Code (DGPC)

Aggregator

DOKU Exclusive

DOKU's BIN in Acquirer, that DOKU provides only for 1 merchant to use. Please contact sales team to get DOKU Exclusive BIN

DOKU Exclusive BIN (starting from 8 digit) + Free Digit (max. 8 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Direct

Direct

Merchant’s Acquirer BIN. Please contact sales team to get Direct BIN from Acquirer

Merchant’s Acquirer BIN (4 digit) + Free Digit (max. 12 digit)

Merchant Generated Payment Code (MGPC), Direct Inquiry (DIPC)

Fix virtual account number is 16 digit.

Reusable Status

Reusable Status is a parameter in API to indicate if Payment Code can be paid more than once, set this to true if merchants wish to enable it.

Here is a reusable status explanation. Set this value in the API, to implement reusable status.

Value
Description

Payment Code can be paid more than once

Payment Code can only be paid once

Note

By default, DOKU will set the value to false, if you don't send this parameter on request.


What's next?

You can learn more about how to integrate to each payment channels you wish by clicking the menu on the sidebar.

PreviousB2B2CNextCIMB Virtual Account

Last updated 7 months ago

Was this helpful?

FIX_BILL
NO_BILL
BILL_VARIABLE_AMOUNT
true
false