Override Notification URL

This is a feature that intended to override the configured Notification URL from API request level. When the override URL is defined on request level, then the notification will be send to the newly destined URL instead of the configured one. To override, make sure you already configure the Notification URL on DOKU Back Office.

Override URL path must be the same as the configured Notification URL path

For example, if the configured URL is https://example.com/payments/notifications , then the override URL must be https://anotherexample.com/payments/notifications . As you can see that both URL contains payments/notifications which is the same path.

You can't use the same domain with different path

You can change the domain or sub-domain, but it is mandatory to make sure the override URL and the configured Notification URL have the same path, otherwise this features won't work.

How To Use

When requesting payment, you have to add this parameter under the additional info on the request body.

{
...
    "additional_info": {
        "override_notification_url": "https://anotherexample.com/payments/notifications"
    }
...
}

The override_notification_url parameter is used for overriding URL, you can simply fill the value with your override URL. After this, all payment notification in this specific channel will be sent to the new destined URL.

Last updated