BTN v1.0
DOKU has partnered with various banks and one of them is BTN to provide Virtual Account Payment. Learn more about how DOKU can help you integrate with BTN Virtual Account here.
Last updated
Was this helpful?
DOKU has partnered with various banks and one of them is BTN to provide Virtual Account Payment. Learn more about how DOKU can help you integrate with BTN Virtual Account here.
Last updated
Was this helpful?
There is one method to integrate with BTN 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:
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 BTN 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.
Here is the overview of how to integrate Direct Inquiry BTN VA :
Setup Inquiry URL on DOKU Dashboard
Generate Payment Code on your End
Receive Inquiry Request from DOKU
Acknowledge Payment Notification
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.
Please inform the Inquiry URL
for Sandbox environment and Production environment.
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
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.
Merchant Generate Payment Code
/bi-snap-va/btn/v1/transfer-va/create-va
Client's current local time in yyyy-MM- ddTHH:mm:ssTZD format
2020-12-21T07:56:11.000Z
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
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
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
0000001702529163
partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | min length: 1 | max length: 28
0000001702529163
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
DOKU Generate Payment Code
/bi-snap-va/btn/v1/transfer-va/create-va
Client's current local time in yyyy-MM- ddTHH:mm:ssTZD format
2020-12-21T07:56:11.000Z
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
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
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
Direct Inquiry
/url-direct-inquiry-merchant
Client's current local time in yyyy-MM- ddTHH:mm:ssTZD format
2020-12-21T07:56:11.000Z
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
VA004
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
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
903415370000000000112
Channel code from bank | min length: 1 | max length: 5
1
Transaction date
2023-01-01T10:55:00+07:00
Language | min length: 1 | max length: 2
ID
Unique Inquiry request id | min length: 1 | max length: 30
12839218738127830
Additional Information for custom use | min length: 1 | max length: Unlimited