Danamon Virtual Account
DOKU has partnered with various banks and one of them is Danamon to provide Virtual Account Payment. Learn more about how DOKU can help you integrate with Danamon Virtual Account here.
Last updated
Was this helpful?
DOKU has partnered with various banks and one of them is Danamon to provide Virtual Account Payment. Learn more about how DOKU can help you integrate with Danamon Virtual Account here.
Last updated
Was this helpful?
There are two methods to integrate with BNI VA:
Create VA: 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.)
DOKU Generated Payment Code (DGPC): The VA number is generated by DOKU. Suitable for e-commerce business model.
Merchant Generated Payment Code (MGPC): The VA number is generated by Merchant. Suitable for top up business model.
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.)
Precondition
Here is the overview of how to integrate with Virtual Account:
To create Payment Code, you will need to hit this API through your Backend:
Service Code
27
HTTP Method
POST
API Endpoint Sandbox
API Endpoint Production
Path
Here is the sample request header, request body and response body for Danamon VA :
Check this flow diagram to get know about this method.
Request Header
X- TIMESTAMP
String
Mandatory
Client's current local time in yyyy-MM-ddTHH:mm:ssZ format
X-SIGNATURE
String
Mandatory
X-PARTNER-ID
String
Mandatory
Unique ID for a partner (Merchant Client ID )
X-EXTERNAL-ID
String
Mandatory
Numeric string. Reference number that should be unique in the same day ( request-id)
CHANNEL-ID
String
Mandatory
channel ID for VA
Authorization
String
Mandatory
Check this flow diagram to get know about this method!
Request Header
X- TIMESTAMP
String
Mandatory
Client's current local time in yyyy-MM-ddTHH:mm:ssZ format
X-SIGNATURE
String
Mandatory
X-PARTNER-ID
String
Mandatory
Unique ID for a partner (Merchant Client ID )
X-EXTERNAL-ID
String
Mandatory
Numeric string. Reference number that should be unique in the same day ( request-id)
CHANNEL-ID
String
Mandatory
channel ID for VA
Authorization
String
Mandatory
Pro Tips!
You can also show payment instruction link to your customer by using additionalInfo.howToPayPage
If you wish to customize the UI for the payment instruction, you can use the additionalInfo.howToPayApi
You can display the payment code to your customer by using virtualAccountData.virtualAccountNo
that you retrieved from the API response.
Payment Notification
If you wish to delete your virtual account, you can do that by hitting the API with this API :
Request Header
X- TIMESTAMP
String
Mandatory
Client's current local time in yyyy-MM-ddTHH:mm:ssZ format
X-SIGNATURE
String
Mandatory
X-PARTNER-ID
String
Mandatory
Unique ID for a partner (Merchant Client ID )
X-EXTERNAL-ID
String
Mandatory
Numeric string. Reference number that should be unique in the same day ( request-id)
CHANNEL-ID
String
Mandatory
channel ID for VA
Authorization
String
Mandatory
If you wish to update your virtual account, you can do that by hitting the API with this API :
Request Header
X- TIMESTAMP
String
Mandatory
Client's current local time in yyyy-MM-ddTHH:mm:ssZ format
X-SIGNATURE
String
Mandatory
X-PARTNER-ID
String
Mandatory
Unique ID for a partner (Merchant Client ID )
X-EXTERNAL-ID
String
Mandatory
Numeric string. Reference number that should be unique in the same day ( request-id)
CHANNEL-ID
String
Mandatory
channel ID for VA
Authorization
String
Mandatory
DOKU supports open payment meaning that your customer can input their own payment amount. To use open amount, you need to set virtualAccountTrxType
= 2
and you need to send totalAmount.value
= 0
and totalAmount.currency
= IDR
DOKU. Here is the sample:
Service Code
24
HTTP Method
POST
API Endpoint Sandbox
Copy
API Endpoint Production
Copy
Path
Copy
Here is the overview of how to integrate Direct Inquiry BNI VA
Check this flow to diagram to get know about this API :
To get Inquiry Request from DOKU, you will need to hit this API through your Backend:
To receive the inquiry request from DOKU. You must set your Inquiry URL
to DOKU. Please contact our team for the setup.
Generate payment is done in your system. The payment code length maximum is 23
digits.
Here is the sample request header, request body from DOKU
Request Header
X- TIMESTAMP
String
Mandatory
Client's current local time in yyyy-MM-ddTHH:mm:ssZ format
X-SIGNATURE
String
Mandatory
X-PARTNER-ID
String
Mandatory
Unique ID for a partner (Merchant Client ID )
X-EXTERNAL-ID
String
Mandatory
Numeric string. Reference number that should be unique in the same day ( request-id)
CHANNEL-ID
String
Mandatory
channel ID for VA
Authorization
String
Mandatory
Algorithm symmetric signature HMAC_SHA2512(clientSecret, stringToSign) Refer to this
Bearer "access token" obtained from Get B2B Token API , refer to this
Algorithm symmetric signature HMAC_SHA2512(clientSecret, stringToSign) Refer to this
Bearer "access token" obtainedn from Get B2B Token API , refer to this
After the payment is being made by your customer, DOKU will send HTTP Notification to your defined Notification URL
. Learn how to .
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 .
Algorithm symmetric signature HMAC_SHA2512(clientSecret, stringToSign) Refer to this
Bearer "access token" obtainedn from Get B2B Token API , refer to this
Algorithm symmetric signature HMAC_SHA2512(clientSecret, stringToSign) Refer to this
Bearer "access token" obtainedn from Get B2B Token API , refer to this
Algorithm symmetric signature HMAC_SHA2512(clientSecret, stringToSign) Refer to this
Bearer "access token" obtainedn from Get B2B Token API , refer to this
After the payment is being made by your customer, DOKU will send HTTP Notification to your defined Notification URL
. Learn how to .
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 .
Payment Notification
Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00
2024-03-19T14:39:01+07:00
Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
Unique ID for a partner (DOKU'S Client ID)
821508239190
Numeric String. Reference number that should be unique in the same day (request-id)
418075533589
channel Id for VA
VA005
Access Token obtained from Get B2B Token API
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ
similar to company code/BIN,8 digit left padding space. | min length: 1 | max length: 8
89656
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | 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
8965600000000000000000001
Customer Name. | Mandatory | min length: 1 | max length: 255
Toru Yamashita
Transaction ID in Partner system. | Mandatory | min length: 1 | max length: 64
23219829713
Unique identifier generated by PJP. If Payment comes from the Inquiry process, this value must be the same with inquiryRequestId. | Mandatory | min length: 1 | max length: 30
12839218738127830
Customer Email | min length: 1 | max length: 255
toru@oor.com
Customer Phone, Format: 62xxxxxxxxx xxxx | min length: 9 | max length: 30
081293912081
DOKU's transaction date time
2023-01-01T10:55:00+07:00
Payment Notification
Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00
2024-03-19T14:39:01+07:00
Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
Unique ID for a partner (DOKU'S Client ID)
821508239190
Numeric String. Reference number that should be unique in the same day (request-id)
418075533589
channel Id for VA
VA005
Access Token obtained from Get B2B Token API
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ
similar to company code/BIN,8 digit left padding space. | min length: 1 | max length: 8
89656
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | 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
8965600000000000000000001
Customer Name. | Mandatory | min length: 1 | max length: 255
Toru Yamashita
Transaction ID in Partner system. | Mandatory | min length: 1 | max length: 64
23219829713
Unique identifier generated by PJP. If Payment comes from the Inquiry process, this value must be the same with inquiryRequestId. | Mandatory | min length: 1 | max length: 30
12839218738127830
Customer Email | min length: 1 | max length: 255
toru@oor.com
Customer Phone, Format: 62xxxxxxxxx xxxx | min length: 9 | max length: 30
081293912081
DOKU's transaction date time
2023-01-01T10:55:00+07:00
Direct Inquiry
Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00
2024-03-19T14:39:01+07:00
Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
Unique ID for a partner (DOKU'S Client ID)
BRN-0259-1678068334526
Numeric String. Reference number that should be unique in the same day (request-id)
418075533589
channel Id for VA
VA009
Access Token obtained from Get B2B Token API
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ
similar to company code/BIN,8 digit left padding space. | Mandatory | min length: 1 | max length: 8
89226
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | 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
8922600000000000000000001
Channel code from bank | min length: 1 | max length: 10
1
Transaction date. | Mandatory
2023-01-01T10:55:00+07:00
Language | min length: 1 | max length: 2
ID
Unique Inquiry request id. | Mandatory | min length: 1 | max length: 30
12839218738127830
Delete Payment Code
Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00
2024-03-19T14:39:01+07:00
Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
Unique ID for a partner (DOKU'S Client ID)
BRN-0259-1678068334526
Numeric String. Reference number that should be unique in the same day (request-id)
418075533589
channel Id for VA
VA005
Access Token obtained from Get B2B Token API
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ
similar to company code/BIN,8 digit left padding space. | Mandatory | min length: 1 | max length: 8
89656
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 20
00000000000000000001
partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 28
8965600000000000000000001
Invoice number in Partner system. | Mandatory | min length: 1 | max length: 64
23219829713
Update Payment Code
Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00
2024-03-19T14:39:01+07:00
Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
Unique ID for a partner (DOKU'S Client ID)
BRN-0259-1678068334526
Numeric String. Reference number that should be unique in the same day (request-id)
418075533589
channel Id for VA
VA005
Access Token obtained from Get B2B Token API
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ
similar to company code/BIN,8 digit left padding space. | Mandatory | min length: 1 | max length: 8
89656
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 20
00000000000000000001
partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 28
8965600000000000000000001
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
Invoice number in Partner system. | Mandatory | min length: 1 | max length: 64
23219829713
Transaction ID in Partner system. 1 (Closed Payment) & 2 (Open Payment) | Mandatory | min length: 1 | max length: 1
1
Expiration date for Virtual Account. ISO-8601
2023-01-01T10:55:00+07:00
Merchant Generate Payment Code
Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00
2024-03-19T14:39:01+07:00
Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
Unique ID for a partner (DOKU'S Client ID)
BRN-0259-1678068334526
Numeric String. Reference number that should be unique in the same day (request-id)
418075533589
channel Id for VA
VA005
Access Token obtained from Get B2B Token API
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ
similar to company code/BIN,8 digit left padding space. | Mandatory | min length: 1 | max length: 8
89226
Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 20
00000000000000000001
partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | Mandatory | min length: 1 | max length: 28
8922600000000000000000001
Customer Name. | Mandatory | 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
Invoice number in Partner system. | Mandatory | min length: 1 | max length: 64
23219829713
Transaction ID in Partner system. 1 (Closed Payment) & 2 (Open Payment) | Mandatory | min length: 1 | max length: 1
1
Expiration date for Virtual Account. ISO-8601
2023-01-01T10:55:00+07:00
DOKU Generate Payment Code
Client's current local time in yyyy-MM-dd'T'HH:mm:ssXXX format. Sample: 2024-03-19T14:39:01+07:00
2024-03-19T14:39:01+07:00
Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)
85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
Unique ID for a partner (DOKU'S Client ID)
BRN-0259-1678068334526
Numeric String. Reference number that should be unique in the same day (request-id)
418075533589
channel Id for VA
VA005
Access Token obtained from Get B2B Token API
Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ
similar to company code/BIN,8 digit left padding space. | Mandatory | min length: 1 | max length: 8
89226
Customer Name. | Mandatory | 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
Invoice number in Partner system. | Mandatory | min length: 1 | max length: 64
23219829713
Transaction ID in Partner system. 1 (Closed Payment) & 2 (Open Payment) | Mandatory | min length: 1 | max length: 1
1
Expiration date for Virtual Account. ISO-8601
2023-01-01T10:55:00+07:00