ID - Indonesia
ID - Indonesia
- Introduction
- Getting Started
- Checkout API
- Build a Checkout Page
- Direct API
- Cards
- Payment Form
- Host-to-host Payment
- Bank Transfer
- BCA Virtual Account
- BNC Virtual Account
- BNI Virtual Account
- BRI Virtual Account
- BSI Virtual Account
- BTN Virtual Account
- DANAMON Virtual Account
- MANDIRI Virtual Account
- MAYBANK Virtual Account
- PERMATA Virtual Account
- SINARMAS Virtual Account
- CIMB SNAP Virtual Account
- Convenience Store
- e-Wallet
- Direct Debit
- PayLater
- Kartu Kredit Indonesia
- Online RefundPOST
- Payout API
- Check Status API
- Partner API
- Biller API
- Wallet Service API
- Webhooks
- Sub Account API
- Use Case Guides
- Error Handling
- FAQ / Troubleshooting
- Change Log
- Archive
Step 1 - Generate Payment Page
POST
/credit-card/v1/payment-page
| Header Parameter | Type | Description |
|---|---|---|
| Client-Id | string | The Client ID you retrieved from DOKU Back OfficeMANDATORY |
| Request-Id | string | Random string that must unique per request for idempotencyMANDATORY ALPHA NUMERIC 40 chars |
| Request-Timestamp | string | Request time in ISO8601 format with UTC + 0MANDATORY |
| Signature | string | Security parameter to ensure the request's authenticity. Learn more how to generate Signature hereMANDATORY |
Request
Header Params
Client-Id
stringÂ
required
Example:
{{client_id}}
Request-Id
stringÂ
required
Example:
{{request_id}}
Request-Timestamp
stringÂ
required
Example:
{{request_timestamp}}
Signature
stringÂ
required
Example:
{{signature}}
Body Params application/json
order
objectÂ
required
invoice_number
stringÂ
required
line_items
array [object {3}]Â
required
amount
integerÂ
required
callback_url
stringÂ
required
auto_redirect
booleanÂ
required
session_id
stringÂ
required
customer
objectÂ
required
id
stringÂ
required
name
stringÂ
required
email
stringÂ
required
phone
stringÂ
required
address
stringÂ
required
country
stringÂ
required
override_configuration
objectÂ
required
themes
objectÂ
required
Example
{
"order": {
"invoice_number":"INV-{{$timestamp}}",
"line_items": [
{
"name": "DOKU T-Shirt Merah",
"price": 30000,
"quantity": 2
},
{
"name": "DOKU T-Shirt Biru",
"price": 30000,
"quantity": 1
}
],
"amount": 90000,
"callback_url": "https://doku.com",
"auto_redirect": false,
"session_id": "0000231223"
},
"customer": {
"id":"W7rbKhPYh76VSHYwHRaGDIbBhgTebgAoWtX",
"name":"Anton Budiman",
"email":"anton@doku.com",
"phone":"+6281287458232",
"address":"Jakarta, Menara Mulia Lt 8",
"country":"ID"
},
"override_configuration": {
"themes": {
"language": "ID",
"background_color": "",
"font_color": "",
"button_background_color": "",
"button_font_color": ""
}
}
}Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/credit-card/v1/payment-page' \
--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": {
"invoice_number":"INV-{{$timestamp}}",
"line_items": [
{
"name": "DOKU T-Shirt Merah",
"price": 30000,
"quantity": 2
},
{
"name": "DOKU T-Shirt Biru",
"price": 30000,
"quantity": 1
}
],
"amount": 90000,
"callback_url": "https://doku.com",
"auto_redirect": false,
"session_id": "0000231223"
},
"customer": {
"id":"W7rbKhPYh76VSHYwHRaGDIbBhgTebgAoWtX",
"name":"Anton Budiman",
"email":"anton@doku.com",
"phone":"+6281287458232",
"address":"Jakarta, Menara Mulia Lt 8",
"country":"ID"
},
"override_configuration": {
"themes": {
"language": "ID",
"background_color": "",
"font_color": "",
"button_background_color": "",
"button_font_color": ""
}
}
}'Responses
🟢200Success
application/json
Body
object {0}
Example
{}Modified at 2025-07-22 07:03:47