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

TypeValue

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: BRN-0001-10791114622547
Request-Id: fdb69f47-96da-499d-acec-7cdc318ab2fe
Request-Timestamp: 2020-08-11T08:45:42Z
Signature: HMACSHA256=1jap2tpgvWt83tG4J7IhEwUrwmMt71OaIk0oL0e6sPM=
ParameterDescription

client-id

Client ID (Brand ID) will be shared by DOKU Account Manager

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

Request Parameters

{
    "business": {
        "type": "PERSONAL",
        "callback_url": "https://webhook.site/80d98e6e-9ac2-4629-99e2-f082b8cdc761",
        "legal_entity": "PERSEORANGAN",
        "name": "Flip Merchant 26 May",
        "description": "Flip Merchant Description",
        "email": "flip26maydemo@gmail.com",
        "phone_calling_code": "62",
        "phone_number": "81510229216",
        "website_readiness": "DONT_HAVE",
        "mobile_app_readiness": "DONT_HAVE",
        "brands": [
            {
                "name": "Brand Flip Merchant 26 May",
                "description": "Flip Merchant 26 May Brand Description",
                "category": "NON_RETAIL",
                "transaction_frequency": "UMI",
                "transaction_quantity": "UP_TO_100",
                "social_media": [
                    {
                        "accounts": [
                            "https://www.instagram.com/flipmerchant"
                        ],
                        "code": "INSTAGRAM"
                    },
                    {
                        "accounts": [
                            "https://www.facebook.com/flipmerchant"
                        ],
                        "code": "FACEBOOK"
                    }
                ],
                "photo_proofs": [
                    {
                        "id": "DCM-0131-1685080834743"
                    }
                ]
            }
        ],
        "addresses": [
            {
                "area": "17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat",
                "country": "ID",
                "name": "Jalan utara timur no 123, Bekasi Utara",
                "primary": true
            }
        ],
        "banks": [
            {
                "account_name": "David Bayu",
                "account_number": "12345058",
                "bank_id": "4",
                "bank_name": "BANK BCA",
                "country": "ID",
                "currency": "IDR",
                "swift_code": "014"
            }
        ],
        "contacts": [
            {
                "documents": [
                    {
                        "code": "KTP",
                        "category": "DOCUMENT",
                        "id": "DCM-0132-1685080899883",
                        "forms": [
                            {
                                "code": "NO_KTP",
                                "value": "1234567890123456"
                            }
                        ]
                    }
                ],
                "email": "david@mail.com",
                "name": "David",
                "nationality": "ID",
                "phone_calling_code": "62",
                "phone_number": "819102329",
                "position": "OWNER",
                "primary": true,
                "owner_liveness": {
                    "id": "CNT-0114-1685080945705"
                }
            }
        ]
    },
     "partner": {
        "invited_user": [
            "doku@flip.com"
        ]
    }
}
ParameterTypeMandatoryDescription

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.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.addresses.area

string(255)

Mandatory

Business address area, e.g 17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat

business.brands.social_media.accounts

business.brands.social_media.code

business.brands.photo_proofs.id

Filled with file.id from Upload File API

business.contacts.name

business.contacts.email

business.contacts.nationality

business.contacts.phone_calling_code

business.contacts.phone_number

business.contacts.position

business.contacts.primary

business.contacts.owner_liveness.id

Filled with file.id from Upload File API

business.addresses.country

business.addresses.name

business.addresses.primary

Possible Values

business.brands.category

ValueDescription

RETAIL

Selling physical product

NON_RETAIL

Selling digital product or services

ParameterPossible Values

businessType

PERSONAL

businessLegalEntity

PERSEORANGAN

businessContactNationality

ID

Response

{
    "business": {
        "type": "PERSONAL",
        "name": "Business under partner personal to check partner identifier CRM",
        "description": "Description test untuk personal partner CRM DOKU",
        "email": "jasmine_partnernew@doku.com",
        "phone_calling_code": "62",
        "phone_number": "81510229216",
        "id": "BSN-0105-1679386730076",
        "status": "UPDATING",
        "utm_source": "test_source",
        "utm_medium": "test_medium",
        "utm_campaign": "test_campaign",
        "partner": "BRN-0201-1676357010382",
        "website_readiness": "HAVE",
        "mobile_app_readiness": "UNDER_DEVELOPMENT",
        "legal_entity": "PERSEORANGAN",
        "created_by": "BRN-0201-1676357010382",
        "is_partner": true,
        "brands": [
            {
                "id": "BRN-0110-1679386730076",
                "name": "Brand under partner personal only test",
                "status": "UPDATING",
                "category": "NON_RETAIL",
                "shared_key": "SK-HmVXe6G7s3PVIoQ6UB4Q",
                "minimum_transaction": 0,
                "maximum_transaction": 100,
                "transaction_frequency": "UMI",
                "transaction_quantity": "UP_TO_100",
                "ticket_size": "UP_TO_50K",
                "social_media": [
                    {
                        "id": "SCM-0109-1679386730083",
                        "account": "https://www.instagram.com/dokuid",
                        "status": "UPDATING",
                        "name": "INSTAGRAM"
                    },
                    {
                        "id": "SCM-0110-1679386730086",
                        "account": "https://www.facebook.com/dokuid",
                        "status": "UPDATING",
                        "name": "FACEBOOK"
                    }
                ],
                "photo_proofs": [
                    {
                        "id": "PHP-0128-1679386730086",
                        "category": "PHOTO_PROOF",
                        "link": "https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0105-1679386730076/PHOTO_PROOF/BRN-0110-1679386730076/1679386730088.jpeg?Expires=1742458730&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=mwfJD9hTaEw3sf6ulF8tmBIFjek%3D",
                        "status": "UPDATING"
                    }
                ],
                "services": [
                    {
                        "id": "PRD-0168-1679386730171",
                        "code": "ONLINE_TO_OFFLINE_ALFA_AGGREGATOR",
                        "name": "Alfa Group (Aggregator)",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0169-1679386730191",
                        "code": "DOKU_WALLET",
                        "name": "DOKU Wallet",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0170-1679386730196",
                        "code": "PEER_TO_PEER_AKULAKU",
                        "name": "Akulaku",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0171-1679386730202",
                        "code": "VIRTUAL_ACCOUNT",
                        "name": "Virtual Account (Multiple Banks)",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0172-1679386730208",
                        "code": "VIRTUAL_ACCOUNT_PARTNER_AGGREGATOR",
                        "name": "VA Aggregator (Multiple Banks)",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0173-1679386730213",
                        "code": "CREDIT_CARD_AGGREGATOR",
                        "name": "Credit Card (Partner Agregator)",
                        "status": "ACTIVE"
                    }
                ]
            }
        ],
        "contacts": [
            {
                "id": "CNT-0125-1679386730283",
                "name": "contact jasmine under partner ke 2",
                "email": "business_contact+1@doku.com",
                "phone_calling_code": "62",
                "phone_number": "8191029",
                "position": "OWNER",
                "nationality": "Indonesia",
                "primary": true,
                "documents": [
                    {
                        "id": "DCM-0140-1679386730296",
                        "category": "DOCUMENT",
                        "code": "KTP",
                        "forms": [
                            {
                                "code": "NO_KTP",
                                "value": "1234567890123456"
                            }
                        ],
                        "link": "https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0105-1679386730076/DOCUMENT/CNT-0125-1679386730283/KTP/DCM-0140-1679386730296/1679386730298.jpg?Expires=1742458730&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=VMkDjfYxArtSlOXbV7CfGfwCuM8%3D"
                    },
                    {
                        "id": "CNT-0125-1679386730283",
                        "category": "OWNER_LIVENESS",
                        "link": "https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0105-1679386730076/OWNER_LIVENESS/DEFAULT/1679386730364.jpeg?Expires=1742458730&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=g9Cxhm3efgb2ftlE%2BDvfM%2Fh8oEM%3D"
                    }
                ]
            }
        ],
        "addresses": [
            {
                "name": "Jalan raya kaliabang tengah no 78, bekasi utara",
                "area": "17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat",
                "country": "Indonesia",
                "primary": true
            }
        ],
        "banks": [
            {
                "account_name": "Jasmine Test QA",
                "account_number": "12345058",
                "currency": "Indonesian rupiah",
                "bank_name": "BANK BCA",
                "overseas": false,
                "swift_code": "014",
                "country": "Indonesia"
            }
        ]
    }
}

business.id

String(22)

BSN-0102-1676676916608

Business ID Merchant

business.status

String(10)

UPDATING

business.partner

String(320)

BRN-0231-1675929715659

Partner ID

business.created_by

String(320)

BRN-0231-1675929715659

Partner ID

business.brands.id

String(22)

BRN-0102-1676676916608

Brand ID Merchant

business.brands.shared_key

String(255)

SK-mNWhry06VRwzIHnxKnQ9

business.brands.social_media.id

String(22)

SCM-0103-1676676916616

business.brands.social_media.status

String(22)

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