Skip to main content

HTTP Notification

DOKU uses HTTP Notification to notify your application when an event happens in your account. HTTP Notification particularly useful for asychronous events such as when your customer completes the payment process for Virtual Account or etc. Not all DOKU integration require HTTP Notification. Keep reading to learn more about what HTTP Notification is and when you should use them.

What is HTTP Notification

HTTP Notification is a notification that DOKU send to notify your application for certain events. Basically, you need to setup an endpoint on your side to receive the notification, which could be written in Java, PHP, Python, Node.js, or anything. The HTTP Notification endpoint has an associated URL (e.g., https://your-domain.com/notifications/payments).

DOKU will send the notification body in JSON format, therefore you can parse it with JSON parser. Please mind that DOKU might add new fields in the notification body in order to cover new use cases in our notification service, you are suggested to parse it in non strict format. This prevents the parser from throwing an error or exception for new fields.

When to use HTTP Notification

These are various cases that DOKU will send notification to you:

  1. Virtual Account Payment
  2. O2O Payment
  3. Credit Card Payment
  4. E-Money Payment
  5. Direct Debit Payment
  6. P2P Payment

What's next?

Learn more about how to get notified by DOKU by setting up the Notification URL here.