Business Registration API
Used 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.
Endpoint
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
Request Header
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
Request Parameters
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
business.contacts.documents.code
String(255)
Mandatory
KTP
business.contacts.documents.category
String(255)
Mandatory
DOCUMENT
business.contacts.documents.id
String(22)
Mandatory
business.contacts.documents.forms.code
String(255)
Mandatory
NO_KTP
business.contacts.documents.forms.value
String(255)
Mandatory
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
Possible Values
business.brands.category
business.brands.category
RETAIL
Selling physical product
NON_RETAIL
Selling digital product or services
businessType
PERSONAL
businessLegalEntity
PERSEORANGAN
businessContactNationality
ID
business.brands.transaction_frequency
UKE
<200 Mio
UME
200 Mio - 4 Bio
UBE
4 Bio
business.brands.transaction_quantity
UP_TO_100
<100
100_10K
100 - 10.000
MORE_THAN_10K
>10.000
Response
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)
Last updated