To get notified by DOKU, you must setup the Notification URL on DOKU Back Office on Webhook Menu. For security reason, we encourage you to use https:// URL protocol prefix.
Notification URL must be able accesed from Internet
Make sure to input Notification URL that can be reached from Public Internet. DOKU will not be able to send notification to localhost, URL protected with authentication, URL behind VPN, unusual destination port, and etc.
Payment Notification URL for Cards will be on Credit Card Menu
Setup Notification URL for Cards payment channel will be on different menu. Please refer to point 2 below.
Follow the steps below to configure your webhook so you can receive real-time payment notifications from DOKU:
1.
First, open the DOKU Back Office, go to Settings, and select the Webhook menu.
2.
Next, click Create Webhook to add a new webhook configuration. Currently, the webhook only supports the Payment Notification event.
3.
You will be directed to the webhook detail page. Fill in the following fields:
Note
Only active payment channels are displayed in the list.
Description – A brief note to help identify this webhook.
URL Endpoint – Your URL Endpoint Address that will receive payment notifications.
Payment Channel – Select the payment channel you want to enable.
4.
After all fields are completed, click Save to store the webhook configuration. The system will validate the input and perform the save process.
5.
If successful, a confirmation pop-up will appear stating that the webhook has been saved. Your new webhook will be added to the existing webhook list.
6.
Please note that each payment channel can only be linked to one URL Endpoint. This means if a payment channel is already used in another webhook, that channel will no longer appear when you create a new webhook.
2. Setup Cards Webhook for Payment Notification URL#
Follow the steps below to configure your Cards webhook so you can receive real-time payment notifications from DOKU:
1.
First, open the DOKU Back Office, go to Settings, and select the Cards menu under Payment section.
2.
Choose the Payment Configuration tab and you can see the Payment Notification URL settings. After that click Edit button to input your Notification URL.
3.
Input your Notification URL and then click Submit button, then your Payment Notification URL will be saved.
4.
If successful, a confirmation pop-up will appear stating that the notification URL has been saved.
