Make your first API call

Overview

This example helps you generate a hosted payment page using DOKU’s Checkout API, so your customer can pay via Virtual Account (VA) or other methods.

No complexity. Just follow these 3 steps. Are you ready? let's start.

What You Need Before Starting

✅ Your Client ID

✅ Your Secret Key

✅ A tool like Postman or cURL

No OAuth token needed — this API uses HMAC-SHA256 Signature in the headers to protect each request.

Use Case

Accepting a Payment with Checkout Page (Virtual Account)
You want to send an invoice of Rp10.000 to a customer, and let them pay via VA or QRIS on a secure DOKU page.

Step 1: Prepare the Payload

Step 2: Generate Signature Header

To make the request secure, you must generate a Signature header like this:

Convert the JSON body to string (no spaces)

Use secret_key as secret

Hash with HMAC-SHA256

Send the hex digest result

Example code (Node.js):

Step 3: Send the Request

On success, you’ll get this:

Final Step: Redirect Your Customer

Send the customer to the checkout_url.
They’ll see a secure page where they can pay via:

Virtual Account (BCA, BNI, Mandiri)

QRIS

e-Wallets (OVO, Dana, ShopeePay)

Cards

etc.

✅ Done!

You just created your first DOKU Checkout payment.
No tokens. No complexity. No problem.

What’s Next?

Setup your callback_url to get notified when payment is completed.

Try other amounts and invoice numbers.

Test different payment methods.

Ready to go live? Just swap to Production credentials.

Overview#

Use Case#

Step 1: Prepare the Payload#

Step 2: Generate Signature Header#

Step 3: Send the Request#

Final Step: Redirect Your Customer#