Create Checkout

POST

/v3/checkouts

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

Request

Header Params

Body Params application/json

Examples

Basic RequestFull Request

{
    "id": "8fdC56eo-cC99-46E1-B6AC-4asD8755B25C",
    "order": {
        "amount": 100.05,
        "invoice_number": "INV-20210231-0001",
        "currency": "MYR",
        "expired_at": "2025-10-03T22:22:25.333Z"
    },
    "customer": {
        "name": "John Doe",
        "email": "customer_email@test.com",
        "phone": "+60812345678"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Basic RequestFull Request

curl --location '/v3/checkouts' \
--header 'Authorization: Basic Base64(doku_ak_test_qblFNYngBkEdjEZ16jxxoWSM)' \
--header 'Client-Id: BRN-001-0000001' \
--header 'Request-Timestamp: {{$date.isoTimestamp}}' \
--header 'Idempotency-Id;' \
--header 'Signature;' \
--header 'API-Version: arabica.2025-12-01' \
--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": "2025-10-03T22:22:25.333Z"
    },
    "customer": {
        "name": "John Doe",
        "email": "customer_email@test.com",
        "phone": "+60812345678"
    }
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "id": "8fdC56eo-cC99-46E1-B6AC-4asD8755B25C",
    "order": {
        "amount": 100.05,
        "invoice_number": "INV-20210231-0001",
        "currency": "MYR",
        "expired_at": "2025-10-03T22:22:25.333Z"
    },
    "checkout_experience": {
        "channels": [
            "EWALLET_TNG",
            "INTERNET_BANKING_FPX",
            "EWALLET_GRABPAY"
        ],
        "language": "EN",
        "auto_redirect": true,
        "retry_payment": {
            "enabled": true
        }
    },
    "payment": {
        "checkout_url": "https://sandbox.doku.com/checkout-link-v2/2ebffd22d23e436895ce5c38f7ddcf8620244712094712362",
        "status": "PENDING",
        "state": "INITIATE"
    },
    "customer": {
        "id": "DOKU-CUST-001",
        "name": "John Doe",
        "email": "customer_email@test.com",
        "phone": "+60812345678",
        "country": "MY",
        "address": "Street 1"
    }
}

🟠400Bad Request

🟠401Invalid Authentication & Signature

🟠404Transaction Errors

🔴500Internal Errors

Modified at 2026-10-28 09:45:27

Overview

Retrieve Checkout Status