Initiate Payment

POST

/checkout/v1/payment

Request

Header Params

Client-Id

string

required

Example:

Request-Id

string

required

Example:

Request-Timestamp

string

required

Example:

Signature

string

required

Example:

Body Params application/json

order

object

required

amount

integer

required

invoice_number

string

required

currency

string

required

session_id

string

required

callback_url

string

required

line_items

array [object {3}]

required

payment

object

required

payment_due_date

integer

required

customer

object

required

name

string

required

string

required

phone

string

required

address

string

required

country

string

required

Example

{
    "order": {
        "amount": 10500,
        "invoice_number": "INV-{{$timestamp}}",
        "currency": "IDR",
        "session_id": "SU5WFDferd561dfasfasdfae123c",
        "callback_url": "https://doku.com/",
        "line_items": [
            {
                "name": "DOKU T-Shirt",
                "price": 10500,
                "quantity" : 1
            }
        ]
    },
    "payment": {
        "payment_due_date": 60
    },
    "customer": {
        "name": "Anton Budiman",
        "email": "anton@doku.com",
        "phone": "+6285694566147",
        "address": "Plaza Asia Office Park Unit 3",
        "country": "ID"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/checkout/v1/payment' \
--header 'Client-Id: {{client_id}}' \
--header 'Request-Id: {{request_id}}' \
--header 'Request-Timestamp: {{request_timestamp}}' \
--header 'Signature: {{signature}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order": {
        "amount": 10500,
        "invoice_number": "INV-{{$timestamp}}",
        "currency": "IDR",
        "session_id": "SU5WFDferd561dfasfasdfae123c",
        "callback_url": "https://doku.com/",
        "line_items": [
            {
                "name": "DOKU T-Shirt",
                "price": 10500,
                "quantity" : 1
            }
        ]
    },
    "payment": {
        "payment_due_date": 60
    },
    "customer": {
        "name": "Anton Budiman",
        "email": "anton@doku.com",
        "phone": "+6285694566147",
        "address": "Plaza Asia Office Park Unit 3",
        "country": "ID"
    }
}'

Responses

🟢200Success

application/json

Body

order

object

required

amount

integer

required

invoice_number

string

required

currency

string

required

session_id

string

required

callback_url

string

required

line_items

array [object {3}]

required

payment

object

required

payment_due_date

integer

required

customer

object

required

name

string

required

string

required

phone

string

required

address

string

required

country

string

required

Example

{
    "order": {
        "amount": 10500,
        "invoice_number": "INV-{{$timestamp}}",
        "currency": "IDR",
        "session_id": "SU5WFDferd561dfasfasdfae123c",
        "callback_url": "https://doku.com/",
        "line_items": [
            {
                "name": "DOKU T-Shirt",
                "price": 10500,
                "quantity" : 1
            }
        ]
    },
    "payment": {
        "payment_due_date": 60
    },
    "customer": {
        "name": "Anton Budiman",
        "email": "anton@doku.com",
        "phone": "+6285694566147",
        "address": "Plaza Asia Office Park Unit 3",
        "country": "ID"
    }
}

Modified at 2025-07-10 06:54:07

Checkout

Direct API