FAQ
API Versioning & Migration
What is the difference between V1 and V2?
V2 is the latest version of the Sub Account API with significant improvements over V1:
Status
Live, no longer receiving updates
Live, actively developed
Split rules
-
Automatic per-transaction splitting
Account types
Single account type
IDR + Pending IDR + Points
Built-in VA
-
Auto-assigned DOKU BRI VA per sub-account
API design
Legacy
Standardized headers, HMAC-SHA512 auth
I'm a new merchant. Which version should I use?
Use V2. All new integrations should use the V2 API for the latest capabilities and best experience. See the Sub Account V2 API documentation to get started.
I'm an existing merchant on V1. Do I need to do anything?
No. V1 is still live and fully supported. Your integration will continue to work as-is with no disruption.
However, V1 is no longer receiving updates, all new features and improvements are built on V2 only.
Can I migrate from V1 to V2?
Migration from V1 to V2 is not yet available. We are working on a migration path and will notify existing merchants when it's ready.
In the meantime, your V1 integration continues to work normally.
Will V1 be shut down?
There is no planned shutdown date for V1. Existing merchants can continue using V1. We will communicate well in advance if any changes are planned.
General
How do I activate Sub-Account?
Sub-Account requires verification from the Sales team. Contact Sales to get started.
Does DOKU need a financial institution license to offer Sub-Account?
No. Sub-Account operates as a technology infrastructure layer, not as a financial institution. It provides the tools to manage fund flows, but DOKU itself is not acting as a bank or e-money issuer.
How is Sub-Account accessed?
Two ways:
API: For developers to integrate programmatically into your platform
Dashboard: A web-based interface for operations and finance teams
Both show the same data in real time.
Is there a limit on how many sub-accounts I can create?
No. There is no fixed limit on the number of sub-accounts you can create. Scale as your business grows.
How is pricing structured?
Contact Sales for pricing details.
What payout methods are supported?
Bank transfers: To 100+ Indonesian and international banks
E-wallets: To DOKU wallets
Can Sub-Account manage external accounts?
Yes. Sub-Account supports both internal transfers (between sub-accounts on your platform) and external transfers (to bank accounts and e-wallets outside the system).
What currencies are supported?
Sub-Account primarily supports IDR (Indonesian Rupiah). Contact Sales for multi-currency availability.
Developer
When can I payout funds after receiving a payment?
It depends on how the money came in:
BRI VA built-in top-up
Immediately, real-time settlement to DOKU_MERCHANT_IDR
Checkout API / Direct API
After settlement, unds must move from DOKU_PENDING_IDR to DOKU_MERCHANT_IDR first
Merchants cannot initiate transfers from
DOKU_PENDING_IDR. It is system-managed.
What is the double-entry ledger and Level 1 profile?
When a Debit API is called on a sub-account, the system can automatically credit the DOKU_MERCHANT_IDR of a Level 1 (merchant/platform) profile. This enables platforms to aggregate funds from multiple sub-accounts before paying out.
How do I test my integration?
Use the Sandbox environment (https://api-sandbox.doku.com) with your sandbox credentials. No real money is moved in sandbox.
How do I know when a transaction completes?
Two ways:
Notifications, DOKU sends webhooks to your callback URL.
Polling, Call the SAC Transaction Status API with your reference number.
What happens if a transfer fails?
The funds remain in the source sub-account. Check the Transaction Status API for the failure reason, and refer to Error Codes for troubleshooting.
Where can I find Account Linking FAQ?
See the Fund Oversight guide for questions about Account Linking, referral codes, linking/unlinking flows, and data visibility.
Where can I find V1 and V2 API documentation?
V1 API documentation is still available at the Sub Account V1 API docs.
V2 API documentation available at the Sub Account V2 API docs.
Last updated
Was this helpful?