Sign in

v1

latestOpenAPI 3.0.32026-07-23167675.4 KB
Account Management

Register Sub Account

Creates a new sub-account for each party that will receive payments on your platform.

Once created, the sub-account receives:

  • A unique Profile ID
  • One or more Account Numbers (IDR, Pending IDR, Points)

A webhook notification is sent to your callback URL when registration is complete (see Webhook: Register Sub Account below).

post/sub-account/v2.0/register

Headers

X-PARTNER-IDstring required

Your Partner ID (DOKU's Client ID)

X-TIMESTAMPstring date-time required

Client's current local time in ISO 8601 format

X-SIGNATUREstring required

Request signature generated using HMAC_SHA512(clientSecret, stringToSign). The stringToSign is constructed from request components to ensure integrity and prevent tampering.

X-EXTERNAL-IDstring required

Numeric string used as a request reference. Must be unique within the same day (resets daily). Used by DOKU to detect and reject duplicate requests.

Request body

partnerReferenceNostring required

Your merchant-assigned reference number

parentProfileIdstring

Parent Profile ID for hierarchical accounts

referralCodestring

Referral code. DOKU auto-generates if omitted

typestring required

Sub-account type. Use DEFAULT for standard sub-accounts.

emailstring email required

Email address of the account holder. Email address of the account holder.

namestring required

Name of the account holder

phoneNostring

Phone number of the account holder (e.g., 081234567890)

countryCodestring

ISO 3166-1 alpha-2 country code (e.g., ID for Indonesia)

Response

Sub-account registered successfully

responseCodestring
responseMessagestring
parentProfileIdstring
profileIdstring

Newly created Profile ID. Use this to reference the sub-account in future API calls (e.g., Balance Inquiries).