---
title: "Register Sub Account"
method: POST
path: "/sub-account/v2.0/register"
tags: ["Account Management"]
---

# Register Sub Account

`POST /sub-account/v2.0/register`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `X-PARTNER-ID`, `X-TIMESTAMP`, `X-SIGNATURE`, `X-EXTERNAL-ID`

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).

## Headers

- `X-PARTNER-ID` string, required
- `X-TIMESTAMP` string, date-time, required
- `X-SIGNATURE` string, required
- `X-EXTERNAL-ID` string, required

## Request body

- object
  - `partnerReferenceNo` string, required: Your merchant-assigned reference number
  - `parentProfileId` string: Parent Profile ID for hierarchical accounts
  - `referralCode` string: Referral code. DOKU auto-generates if omitted
  - `type` string, required: Sub-account type. Use DEFAULT for standard sub-accounts.
  - `email` string, email, required: Email address of the account holder. Email address of the account holder.
  - `name` string, required: Name of the account holder
  - `phoneNo` string: Phone number of the account holder (e.g., 081234567890)
  - `countryCode` string: ISO 3166-1 alpha-2 country code (e.g., ID for Indonesia)

## Response `200`

Sub-account registered successfully

- object
  - `responseCode` string
  - `responseMessage` string
  - `parentProfileId` string
  - `profileId` string: Newly created Profile ID. Use this to reference the sub-account in future API calls (e.g., Balance Inquiries).
  - `accounts` AccountInfo[]: List of accounts created for this sub-account. Each sub-account can have up to 3 account types: DOKU_MERCHANT_IDR (withdrawable), DOKU_PENDING_IDR (held), DOKU_MERCHANT_POINT (non-cash).
    - `type` string: Account type: DOKU_MERCHANT_IDR (withdrawable IDR), DOKU_PENDING_IDR (held/reserved), DOKU_MERCHANT_POINT (non-cash points)
    - `currency` string: ISO 4217 currency code (IDR) or POINT for non-cash accounts
    - `accountNo` string: Unique account number assigned by DOKU. Use this in transaction APIs (transfers, debits, balance inquiries).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `409`: Duplicate partnerReferenceNo

---

[API](https://skmtc.dev/doku/apis/direct-debit-core-system-notify-binding-to-merchant-emoney-o.md) - [All operations](https://skmtc.dev/doku/apis/direct-debit-core-system-notify-binding-to-merchant-emoney-o/llms.txt) - [OpenAPI document](https://skmtc.dev/doku/apis/direct-debit-core-system-notify-binding-to-merchant-emoney-o/revisions/7887174f57bc?raw)
