Sample Notification - Global

POST

/merchants-url/receive-notification

After setting up your Notification URL, we will send the notification for certain events such as when the payment is succeed, failed, and etc.

Here is the sample notification that DOKU will send to merchant's server.

Request

Authorization

API Key

Add parameter in header

Signature

Example:

Signature: ********************

API Key

Add parameter in header

Client-Id

Example:

Client-Id: ********************

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Header Params

Body Params application/json

Example

{
    "id": "8fdC56eo-cC99-46E1-B6AC-4asD8755B25C",
    "order": {
        "amount": 100.05,
        "invoice_number": "INV-20210231-0001",
        "currency": "MYR",
        "expired_at": "2026-01-16T04:20:42.115Z"
    },
    "payment": {
        "channel": "EWALLET_SHOPEEPAY",
        "type": "SALE",
        "initiation_type": "customer_initiate",
        "amount": 100.05,
        "currency": "MYR",
        "status": "SUCCESS",
        "state": "COMPLETED"
    },
    "customer": {
        "id": "DOKU-CUST-001",
        "name": "John Doe",
        "email": "customer_email@test.com",
        "phone": "+60812345678",
        "country": "MY",
        "address": "Street 1"
    },
    "metadata": {
        "sample_key": "your value"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/merchants-url/receive-notification' \
--header 'Request-Timestamp: {{$date.isoTimestamp}}' \
--header 'API-Version: doku-global.2025-12-01' \
--header 'Signature: <api-key>' \
--header 'Client-Id: <api-key>' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "8fdC56eo-cC99-46E1-B6AC-4asD8755B25C",
    "order": {
        "amount": 100.05,
        "invoice_number": "INV-20210231-0001",
        "currency": "MYR",
        "expired_at": "2026-01-16T04:20:42.115Z"
    },
    "payment": {
        "channel": "EWALLET_SHOPEEPAY",
        "type": "SALE",
        "initiation_type": "customer_initiate",
        "amount": 100.05,
        "currency": "MYR",
        "status": "SUCCESS",
        "state": "COMPLETED"
    },
    "customer": {
        "id": "DOKU-CUST-001",
        "name": "John Doe",
        "email": "customer_email@test.com",
        "phone": "+60812345678",
        "country": "MY",
        "address": "Street 1"
    },
    "metadata": {
        "sample_key": "your value"
    }
}'

Responses

🟢200OK

This response does not have a body.

Modified at 2026-10-28 09:46:37

Setup Notification URL

Sample Notification - Cards