Business Registration API
Last updated
Last updated
DOKU API
Legacy DocumentationUsed for registering a business outside of the DOKU Dashboard. Partners can use this API to create an account and provide their business information, including legal name, address, and contact information. After uploading the necessary documents using the API Upload Document, partners can input their business information in this component.
Type | Value |
---|---|
Parameter | Description |
---|---|
business.brands.category
business.brands.transaction_frequency
business.brands.transaction_quantity
Parameter | Type | Mandatory | Description |
---|---|---|---|
Parameter | Data Type | Mandatory | Possible Value | Description |
---|---|---|---|---|
Value | Description |
---|---|
Parameter | Possible Values |
---|---|
Parameter | Possible Values |
---|---|
Transaction Frequency | Total Amount of Monthly Transaction (Rupiah) |
---|---|
Transaction Quantity | Total Number of Monthly Transaction |
---|---|
Parameter | Data Type | Possible Value | Description |
---|---|---|---|
HTTP Method
POST
API endpoint (Test Mode)
https://api-uat.doku.com/adv-core-api/partner/v1.0/business
API endpoint (Production)
https://api.doku.com/adv-core-api/partner/v1.0/business
client-id
Use Brand ID for Partner
request-id
Unique random string (max 128 characters) generated from merchant side to protect duplicate request
request-timestamp
Timestamp request on UTC time in ISO8601 UTC+0 format. It means to proceed transaction on UTC+7 (WIB), merchant need to subtract time with 7. Ex: to proceed transaction on September 22th 2020 at 08:51:00 WIB, the timestamp should be 2020-09-22T01:51:00Z
signature
Security parameter that needs to be generated on merchant Backend and placed to the header request to ensure that the request is coming from valid merchant. Please refer to this section to generate the signature
business.type
string(8)
Mandatory
Possible Value : PERSONAL
business.legal_entity
string
Mandatory
PERSEORANGAN
business.name
string
Mandatory
For PERSONAL, business.name same as business.brands.name
business.email
string
Mandatory
Business Email
business.description
String(1023
Optional
For PERSONAL, business.description
same as business.brands.description
business.calling_code
int(2)
Mandatory
Business calling code .e.g 62
business.phone_number
int(13)
Mandatory
Business phone number
business.brands.name
string(255)
Mandatory
For PERSONAL
, business.brands.name
same as business.name
e.g. Merona Store
business.brands.category
string(10)
Mandatory
business.brands.description
string(1023)
Mandatory
For PERSONAL, business.brands.description same as business.description
business.brands.transaction_frequency
string(3)
Optional
business.brands.transaction_quantity
string(255)
Optional
business.addresses.area
string(255)
Mandatory
Business address area, e.g 17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat
business.addresses.country
String(2)
Mandatory
ID
business.addresses.name
String(255)
Mandatory
Business addresses name, e.g Jalan Gatot Subroto No 20
business.addresses.primary
boolean
Mandatory
Is the business address as primary ? Value : true/false
business.contacts.name
String(255)
Mandatory
Business contacts name
business.contacts.email
String(320)
Mandatory
Business contacts email
business.contacts.nationality
String(2)
Mandatory
Business contacts nationality, e.g ID
business.contacts.phone_calling_code
Integer(2)
Mandatory
62
business.contacts.phone_number
Integer(14)
Mandatory
Business phone number
business.contacts.position
String(255)
Mandatory
Default: OWNER
business.contacts.primary
boolean
Mandatory
Is the business contacts is primary contact ? Value : true/false
business.contacts.owner_liveness.id
String(255)
Mandatory
Filled with file.id
from Upload File API
business.contacts.documents.code
String(255)
Mandatory
KTP
business.contacts.documents.category
String(255)
Mandatory
DOCUMENT
business.contacts.documents.id
String(22)
Mandatory
Generated from Upload File API
business.contacts.documents.forms.code
String(255)
Mandatory
NO_KTP
business.contacts.documents.forms.value
String(255)
Mandatory
Generated from Upload File API
business.banks.account_name
String(255)
Mandatory
The account name
business.banks.account_number
Integer(255)
Mandatory
The bank account number
business.banks.bank_id
String(3)
Mandatory
4 [Bank ID]
business.banks.bank_name
String(255)
Mandatory
BANK BCA [Bank Name]
business.banks.country
String(2)
Mandatory
ID
business.banks.currency
String(3)
Mandatory
Only IDR
business.banks.swift_code
String(11)
Mandatory
014 [Swift Code Bank]
business.bank_account
String(255)
Mandatory
Generated from Upload File API
business.type
A(9)
Mandatory
CORPORATE
business.legal_entity
AS(120)
Mandatory
business.name
ANS(255)
Mandatory
PT Telkom Indonesia
business.email
ANS(320)
Mandatory
info@doku.com
business.description
ANS(1023)
Optional
An energy company
business.calling_code
N(2)
Mandatory
62
business.phone_number
N(14)
Mandatory
226202333
business.website_readiness
AS(255)
Optional
business.mobile_app_readiness
AS(255)
Optional
business.logo
ANS(255)
Optional
DCM-0101-1675758346870
Address
business.addresses.area
N(5)
17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat
business.addresses.country
A(2)
ID
business.addresses.name
ANS(255)
Jalan Gatot Subroto No. 20
business.addresses.primary
boolean
true
Contacts
business.contacts.name
AS(255)
Ricky Hilmi
business.contacts.email
ANS(320)
ricky@doku.com
business.contacts.nationality
A(2)
ID
business.contacts.phone_calling_code
N(3)
62
business.contacts.phone_number
N(14)
812341234123
business.contacts.position
A(255)
DIRECTOR
business.contacts.primary
boolean
true
business.contacts.owner_liveness.id
ANS(255)
CNT-0123-1234123412341
business.contacts.documents.code
ANS(255)
KTP
business.contacts.documents.category
A(255)
DOCUMENT
business.contacts.documents.id
ANS(22)
DCM-0154-1234123412341
business.contacts.documents.forms.code
AS(255)
NO_KTP
business.contacts.documents.forms.value
N(255)
1234123412341234
Brand Information
business.brands.name
ANS(255)
Brands Corporate Test
business.brands.description
ANS(1023)
Description Brand for Type Corporate
business.brands.transaction_frequency
AN(255)
Mandatory
business.brands.transaction_quantity
AN(255)
Mandatory
business.brands.social_media.account
ANS(255)
business.brands.social_media.code
A(255)
business.brands.photo_proofs.id
ANS(255)
DCM-0113-1678960720885
business.brands.documents.category
A(255)
business.brands.documents.code
A(255)
business.brands.documents.id
ANS(255)
DCM-0123-1675830700734
Bank Account
business.banks.account_name
AN(255)
Ricky Hilmi
business.banks.account_number
N(255)
123123123
business.banks.bank_id
N(3)
4
business.banks.bank_name
A(255)
BANK BCA
business.banks.country
A(2)
ID
business.banks.currency
A(3)
IDR
business.banks.swift_code
N(3)
014
business.bank_account
ANS(255)
BNK-0103-1675758989243
Documents
business.documents.category
A(255)
business.documents.code
A(255)
business.documents.id
ANS(255)
DCM-0102-1675477254423
business.documents.forms.code
A(255)
business.documents.forms.value
N(15)
123456789012934
RETAIL
Selling physical product
NON_RETAIL
Selling digital product or services
businessType
PERSONAL
businessLegalEntity
PERSEORANGAN
businessContactNationality
ID
businessType
CORPORATE
businessLegalEntity
PT
CV
UD
KOPERASI
FIRMA
PP
BUMN
PTN_BH
YAYASAN
PERKUMPULAN_BERBADAN_HUKUM
BLU
brandBusinessLine
AGRICULTURE
CAPITAL_MARKET
CHARITY
COMMUNICATION
DIGITAL_AND_GAME
EDUCATION
EVENT_ORGANIZER
FINANCIAL_SERVICE
FOOD_AND_BEVERAGE
GAS_STATION
HOSPITALITY
INSURANCE
LOGISTICS
MANUFACTURE
MARKETPLACE
MINING
ONLINE_STORE
P2P_LENDING
PROPERTY
PUBLIC_SERVICE
RETAIL
TRANSPORTATION
TRAVEL_AGENT
businessContactNationality
ID
UKE
<200 Mio
UME
200 Mio - 4 Bio
UBE
4 Bio
UP_TO_100
<100
100_10K
100 - 10.000
MORE_THAN_10K
>10.000
business.id
String(22)
BSN-0102-1676676916608
Business ID Merchant
business.status
String(10)
UPDATING
Business Status description:
UPDATING: On Review
ACTIVE: Business Approved
business.partner
String(320)
BRN-0231-1675929715659
Your Partner ID
business.created_by
String(320)
BRN-0231-1675929715659
Your Partner ID
business.brands.id
String(22)
BRN-0102-1676676916608
Generate Brand ID for your merchant
business.brands.shared_key
String(255)
SK-mNWhry06VRwzIHnxKnQ9
Shared Key to generate signature on bhelaf of merchant
business.brands.social_media.id
String(22)
SCM-0103-1676676916616
Social Media Entity Id
business.brands.social_media.status
String(22)
UPDATING,REJECTED,ACTIVE
Social Media Status:
UPDATING: On Review
ACTIVE: Social Media Approved
REJECTED: Social media Rejected
business.brands.photo_proofs
String(22)
PHP-0102-1676676916620
business.brands.photo_proofs.status
String(22)
business.brands.services.id
String(22)
business.brands.services.code
String(255)
business.brands.services.name
String(255)
business.brands.services.status
String(10)
business.brands.contacts.id
String(255)
business.brands.contacts.document
String(255)