BNC v1.0
DOKU has partnered with various banks and one of them is BNC to provide Virtual Account Payment. Learn more about how DOKU can help you integrate with BNC Virtual Account here.
Last updated
DOKU has partnered with various banks and one of them is BNC to provide Virtual Account Payment. Learn more about how DOKU can help you integrate with BNC Virtual Account here.
Last updated
DOKU API
Legacy DocumentationThere is one method to integrate with BNC VA:
Merchant could hit create VA API (service code 27) to create their virtual account number by acquirer. The number created then will be inquired by acquirer, merchant can get the payment notification.
Check this flow diagram to get know about this method
Here is the overview of how to integrate with Virtual Account:
To create Virtual Account, you will need to hit this API through your Backend:
Here is the sample request header, request body and response body for BNC VA
Pro Tips!
You can also show payment instruction link to your customer by using virtual_account_info.how_to_pay_page
If you wish to customize the UI for the payment instruction, you can use the virtual_account_info.how_to_pay_api
You can display the payment code to your customer by using virtual_account_info.virtual_account_number
that you retrieved from the API response.
After the payment is being made by your customer, DOKU will send HTTP Notification to your defined Notification URL
. Learn how to handle the notification from DOKU .
If you do not receive notifications from DOKU due to some issue, you can perform an API status check on the DOKU side to determine the updated transaction status. See the detailed request and response here Check Status API.
Type | Value |
---|---|
Service Code
27
HTTP Method
POST
API Endpoint Sandbox
API Endpoint Production
Path
Merchant Generate Payment Code
Create VA SNAP request
Transaction ID in Partner system. | min length: 1 | max length: 64
"23219829713"
Transaction ID in Partner system. Fil 1 for Closed Payment, fill 2 for Open Payment | min length: 1 | max length: 1
"1"
Expiration date for Virtual Account. ISO-8601
"2023-01-01T10:55:00+07:00"
similar to company code/BIN,8 digit left padding space. | min length: 1 | max length: 8
"90341537"
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | min length: 1 | max length: 20
"00000000000000000001"
partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | min length: 1 | max length: 28
"9034153700000000000000000001"
Customer Name | min length: 1 | max length: 255
"Toru Yamashita"
Customer Email | min length: 1 | max length: 255
"toru@oor.com"
Customer Phone, Format: 62xxxxxxxxx xxxx | min length: 9 | max length: 30
"0816291271826"
item created
Response Code with format HTTP status code + service code + case code. | min length: 1 | max length: 7
"2007300"
Response Description. | min length: 1 | max length: 150
"Successful"
DOKU Generate Payment Code
Create VA SNAP request
Transaction ID in Partner system. | min length: 1 | max length: 64
"23219829713"
Transaction ID in Partner system. Fil 1 for Closed Payment, fill 2 for Open Payment | min length: 1 | max length: 1
"1"
Expiration date for Virtual Account. ISO-8601
"2023-01-01T10:55:00+07:00"
similar to company code/BIN,8 digit left padding space. | min length: 1 | max length: 8
"90341537"
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | min length: 1 | max length: 20
"00000000000000000000"
partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | min length: 1 | max length: 28
"0000000000000000000000000000"
Customer Name | min length: 1 | max length: 255
"Toru Yamashita"
Customer Email | min length: 1 | max length: 255
"toru@oor.com"
Customer Phone, Format: 62xxxxxxxxx xxxx | min length: 9 | max length: 30
"0816291271826"
item created
Response Code with format HTTP status code + service code + case code. | min length: 1 | max length: 7
"2007300"
Response Description. | min length: 1 | max length: 150
"Successful"