Initiate Checkout Order (v2)

POST

/v2/payment

Creates a new checkout order (or returns the existing token/URL if the request is an idempotent
retry) and returns the generated payment token and redirect url.

Processing performed by InitiatePaymentServiceV2.doProcessInitiatePaymentV2:

Validates the order amount and that the merchant (Client-Id) is active.

Validates the invoice number is not already in use, and (when line items are supplied) that
they sum to the requested amount.

Checks idempotency by request_id + invoice_number + amount + client_id; if a matching
pending order already exists, its existing token/URL is returned instead of creating a new order.

Otherwise, validates the requested payment.payment_method_types against the merchant's active
channels, generates a new session/token, persists a new Orders record, and builds the checkout
redirect URL.

Publishes a JDM tracking event with the outcome.

The response does not echo the submitted order/payment/customer payload — only the resulting
token and url are returned under payment.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "order": {
        "amount": "150000",
        "currency": "IDR",
        "invoice_number": "INV-20260710-0002",
        "callback_url": "https://merchant.example.com/callback",
        "callback_url_result": "https://merchant.example.com/callback/result",
        "line_items": [
            {
                "name": "Wireless Mouse",
                "quantity": 2,
                "price": "75000.00",
                "sku": "SKU-WM-001",
                "category": "Electronics",
                "url": "https://merchant.example.com/products/wireless-mouse",
                "image_url": "https://merchant.example.com/images/wireless-mouse.png",
                "type": "PHYSICAL",
                "sub_total": 150000
            }
        ],
        "language": "en",
        "auto_redirect": false,
        "disable_retry_payment": false
    },
    "payment": {
        "payment_method_types": [
            "VIRTUAL_ACCOUNT_BCA"
        ],
        "payment_due_date": 60,
        "token_id": "string",
        "url": "string"
    },
    "customer": {
        "id": "CUST-99887",
        "name": "Budi Santoso",
        "email": "budi.santoso@example.com",
        "phone": "+6281234567890",
        "address": "Jl. Sudirman No. 1, Jakarta",
        "country": "ID",
        "postcode": "12190",
        "state": "DKI Jakarta",
        "city": "Jakarta"
    },
    "additional_info": {
        "remarks": "gift wrap requested"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v2/payment' \
--header 'Client-Id: MCH-00123' \
--header 'Request-Id: req-a1b2c3d4' \
--header 'Request-Timestamp: 2026-07-10T10:15:30+07:00' \
--header 'Signature: SFVKbG9yZW1pcHN1bXNpZ25hdHVyZWV4YW1wbGU9' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order": {
        "amount": "150000",
        "currency": "IDR",
        "invoice_number": "INV-20260710-0002",
        "callback_url": "https://merchant.example.com/callback",
        "callback_url_result": "https://merchant.example.com/callback/result",
        "line_items": [
            {
                "name": "Wireless Mouse",
                "quantity": 2,
                "price": "75000.00",
                "sku": "SKU-WM-001",
                "category": "Electronics",
                "url": "https://merchant.example.com/products/wireless-mouse",
                "image_url": "https://merchant.example.com/images/wireless-mouse.png",
                "type": "PHYSICAL",
                "sub_total": 150000
            }
        ],
        "language": "en",
        "auto_redirect": false,
        "disable_retry_payment": false
    },
    "payment": {
        "payment_method_types": [
            "VIRTUAL_ACCOUNT_BCA"
        ],
        "payment_due_date": 60,
        "token_id": "string",
        "url": "string"
    },
    "customer": {
        "id": "CUST-99887",
        "name": "Budi Santoso",
        "email": "budi.santoso@example.com",
        "phone": "+6281234567890",
        "address": "Jl. Sudirman No. 1, Jakarta",
        "country": "ID",
        "postcode": "12190",
        "state": "DKI Jakarta",
        "city": "Jakarta"
    },
    "additional_info": {
        "remarks": "gift wrap requested"
    }
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "message": "SUCCESS",
    "payment": {
        "token": "sess-e5f6a7b820260710101530002",
        "url": "https://checkout.doku.com/v2/sess-e5f6a7b820260710101530002"
    }
}

Modified at 2026-09-04 07:53:06

Initiate Checkout Order (v1)

Custom Callback URL