Check Three D Secure - DOKU Malaysia API Reference

Endpoint for H2H merchants to check 3D Secure eligibility on a credit card. Returns an authentication URL used to redirect the consumer to the 3DS challenge page.

Environment
Sandbox - https://api-sandbox.doku.com
Production - https://api.doku.com

Request

Header Params

Body Params application/jsonRequired

Examples

SALEAUTHORIZEINSTALLMENT

{
    "order": {
        "amount": 150000,
        "currency": "MYR",
        "invoice_number": "INV-2024-001",
        "descriptor": "DOKU Payment"
    },
    "card": {
        "number": "4111111111111111",
        "expiry": "1225",
        "cardholder_name": "John Doe",
        "cardholder_email_address": "john.doe@example.com",
        "cardholder_phone_number": "081234567890"
    },
    "three_d_secure": {
        "callback_url_success": "https://merchant.com/payment/success",
        "callback_url_failed": "https://merchant.com/payment/failed"
    },
    "payment": {
        "type": "SALE"
    },
    "customer": {
        "id": "CUST-001",
        "name": "John Doe",
        "email": "john.doe@example.com",
        "phone": "081234567890"
    }
}

Responses

🟢200

application/json

Success - returns authentication URL for the 3DS challenge

Bodyapplication/json

Example

{
    "order": {
        "amount": 150000,
        "currency": "MYR",
        "invoice_number": "INV-2024-001"
    },
    "three_d_secure": {
        "authentication_id": "AUTH-20240115-001",
        "authentication_url": "https://3ds.doku.com/authenticate?id=AUTH-20240115-001",
        "three_ds_version": "2.0"
    }
}

🟠400

🟠409

🟠412