Payment Notification

POST

After setting up your Notification URL, we will send the notification for certain events such as when the Credit Card has been charged, Credit Card failed, and etc.

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

Request

Header Params

Body Params application/json

Examples

Example - Card SuccessExample - Cards Refund

{
    "order": {
        "invoice_number": "TEST-AMY-250828-0001",
        "amount": 5,
        "currency": "MYR"
    },
    "customer": {
        "id": "CUST-002",
        "name": "Boyce Monahan",
        "email": "BoyceMonahan@dkgrgsl.com"
    },
    "transaction": {
        "type": "SALE",
        "status": "SUCCESS",
        "date": "2025-08-28T02:56:15Z",
        "original_request_id": "57344"
    },
    "service": {
        "id": "CREDIT_CARD"
    },
    "acquirer": {
        "id": "OCBC"
    },
    "channel": {
        "id": "CREDIT_CARD",
        "name": "Credit Card"
    },
    "card_payment": {
        "masked_card_number": "512345******2346",
        "approval_code": "094066",
        "response_code": "00",
        "response_message": "Approved",
        "issuer": "BANK ISLAM MALAYSIA BERHAD",
        "identifier": [
            {
                "name": "Acquirer",
                "value": "OCBC"
            },
            {
                "name": "MID",
                "value": "TEST19999999988"
            }
        ],
        "brand": "MASTER",
        "token_id": "ab6d4d33d0b08f7c679275afd67bb2b4",
        "authentication_id": "c696bba9b537bf8b99c4cdd5ffa53d52c09c08e2dc54730871d7cf5987c3d108",
        "three_d_secure_status": "TRUE"
    },
    "card": {
        "token": "ab6d4d33d0b08f7c679275afd67bb2b4"
    },
    "verification": {
        "status": "NA",
        "reason": ""
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Example - Card SuccessExample - Cards Refund

curl --location --request POST '/' \
--header 'Client-Id: MCH-0001-10791114622547' \
--header 'Request-Id: 479b663f-5c9d-400d-8e80-3e548a8f7639' \
--header 'Request-Timestamp: 2020-08-11T08:45:42Z' \
--header 'Signature: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order": {
        "invoice_number": "TEST-AMY-250828-0001",
        "amount": 5,
        "currency": "MYR"
    },
    "customer": {
        "id": "CUST-002",
        "name": "Boyce Monahan",
        "email": "BoyceMonahan@dkgrgsl.com"
    },
    "transaction": {
        "type": "SALE",
        "status": "SUCCESS",
        "date": "2025-08-28T02:56:15Z",
        "original_request_id": "57344"
    },
    "service": {
        "id": "CREDIT_CARD"
    },
    "acquirer": {
        "id": "OCBC"
    },
    "channel": {
        "id": "CREDIT_CARD",
        "name": "Credit Card"
    },
    "card_payment": {
        "masked_card_number": "512345******2346",
        "approval_code": "094066",
        "response_code": "00",
        "response_message": "Approved",
        "issuer": "BANK ISLAM MALAYSIA BERHAD",
        "identifier": [
            {
                "name": "Acquirer",
                "value": "OCBC"
            },
            {
                "name": "MID",
                "value": "TEST19999999988"
            }
        ],
        "brand": "MASTER",
        "token_id": "ab6d4d33d0b08f7c679275afd67bb2b4",
        "authentication_id": "c696bba9b537bf8b99c4cdd5ffa53d52c09c08e2dc54730871d7cf5987c3d108",
        "three_d_secure_status": "TRUE"
    },
    "card": {
        "token": "ab6d4d33d0b08f7c679275afd67bb2b4"
    },
    "verification": {
        "status": "NA",
        "reason": ""
    }
}'

Responses

🟢200OK

application/json

Body

Example

{}

Modified at 2025-09-16 09:54:31

Charge

Bank Transfer