Get Business Data 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

Type	Value
HTTP Method	GET
API endpoint (Test Mode)	https://api-uat.doku.com/adv-core-api/partner/v1.0/business/{{client-id under partner}}
API endpoint (Production)	https://api.doku.com/adv-core-api/partner/v1.0/file

Request Header

Client-Id: BRN-0001-10791114622547
Request-Id: fdb69f47-96da-499d-acec-7cdc318ab2fe
Request-Timestamp: 2020-08-11T08:45:42Z
Signature: HMACSHA256=1jap2tpgvWt83tG4J7IhEwUrwmMt71OaIk0oL0e6sPM=

Parameter	Description
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

Query Params	Type	Mandatory	Description
businessType	string	Mandatory	e.g. PERSONAL, CORPORATE
businessLegalEntity	string	Mandatory	e.g. PT, CV, etc. (Possible Values)
brandBusinessLine	string	Mandatory	e.g. RETAIL, DIGITAL_AND_GAME, etc. (Possible Values)
businessContactNationality	string	Mandatory	e.g. ID (ISO2 CODE)

Possible Values

PERSONAL

Parameter	Possible Values
businessType	PERSONAL
businessLegalEntity	PERSEORANGAN
brandBusinessLine	RETAIL
businessContactNationality	ID

CORPORATE

Response Sample

PERSONAL

{
    "id": "BSN-0104-1678960841263",
    "name": "Business under partner personal to check partner identifier CRM",
    "description": "Description test untuk personal partner CRM DOKU",
    "email": "[email protected]",
    "phone_calling_code": "62",
    "phone_number": "81510229216",
    "partner": "BRN-0201-1676357010382",
    "platform": "api",
    "type": "PERSONAL",
    "website_readiness": {
        "code": "HAVE",
        "name": "Have a website"
    },
    "mobile_app_readiness": {
        "code": "UNDER_DEVELOPMENT",
        "name": "Under development"
    },
    "legal_entity": {
        "code": "PERSEORANGAN",
        "name": "Personal"
    },
    "brands": [
        {
            "id": "BRN-0104-1678960841263",
            "name": "Brand under partner personal only test",
            "shared_key": "SK-ViEeAojc5K0nBrL41ou4",
            "category": "NON_RETAIL",
            "minimum_transaction": 0,
            "maximum_transaction": 100,
            "transaction_frequency": {
                "code": "UMI",
                "name": "< IDR 20 Mio"
            },
            "transaction_quantity": {
                "code": "UP_TO_100",
                "name": "< 100"
            },
            "ticket_size": {
                "code": "UP_TO_50K",
                "name": "Less than or equal to IDR 50.000"
            },
            "finance_status": "PROBATION",
            "risk_engine_status": "ON_PROCESS",
            "photo_proofs": [
                {
                    "id": "PHP-0113-1678960841279",
                    "photo": "https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0104-1678960841263/PHOTO_PROOF/BRN-0104-1678960841263/1678960841281.jpeg?Expires=1742713187&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=0t7Fk5RVNrKLC7f4UncQtnqxMb4%3D",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "7e90d35b-dae6-40cb-9aae-6effdec3f3ac",
                    "status": "UPDATING"
                }
            ],
            "social_media": [
                {
                    "id": "SCM-0108-1678960841279",
                    "code": "FACEBOOK",
                    "name": "Facebook",
                    "account": "https://www.facebook.com/dokuid",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "0932625e-8e04-44c3-bb37-36279559e7c0",
                    "status": "UPDATING"
                },
                {
                    "id": "SCM-0107-1678960841271",
                    "code": "INSTAGRAM",
                    "name": "Instagram",
                    "account": "https://www.instagram.com/dokuid",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "a0a4bb73-3ddb-4524-8854-de9b7af90d8f",
                    "status": "UPDATING"
                }
            ],
            "products": [
                {
                    "id": "PRD-0138-1678960841304",
                    "code": "ONLINE_TO_OFFLINE_ALFA_AGGREGATOR",
                    "name": "Alfa Group (Aggregator)",
                    "description": "Accept payments at Alfamart, Alfamidi, Dan+Dan, and Lawson outlets. Your customer will make payment using DOKU's name.",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "5b4e4539-042e-4c27-a71b-cb8d6d4ddd0f",
                    "status": "ACTIVE"
                },
                {
                    "id": "PRD-0139-1678960841330",
                    "code": "DOKU_WALLET",
                    "name": "DOKU Wallet",
                    "description": "Accept payments using DOKU Wallet. Your customer will input DOKU ID and PIN for authorization.",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "22d230c8-6c8d-4c02-8fce-500bcffe576b",
                    "status": "ACTIVE"
                },
                {
                    "id": "PRD-0140-1678960841340",
                    "code": "PEER_TO_PEER_AKULAKU",
                    "name": "Akulaku",
                    "description": "Accept payments using the Akulaku paylater program. This service will require authorization by entering the registered Akulaku account ID and password / OTP.",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "0203a293-e434-4533-b7c7-7e4ce8745dd8",
                    "status": "ACTIVE"
                },
                {
                    "id": "PRD-0141-1678960841350",
                    "code": "VIRTUAL_ACCOUNT",
                    "name": "Virtual Account (Multiple Banks)",
                    "description": "Accept payments using a virtual account number. These services include VA Bank Mandiri, VA BRI, VA BNI, VA BSI, VA Bank CIMB Niaga, VA Bank Permata, VA Bank Danamon, and VA by DOKU. This service does not require a direct agreement with each bank.",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "62a63dc6-bdcc-4c12-9727-d32cbe060efa",
                    "status": "ACTIVE"
                },
                {
                    "id": "PRD-0142-1678960841357",
                    "code": "VIRTUAL_ACCOUNT_PARTNER_AGGREGATOR",
                    "name": "VA Aggregator (Multiple Banks)",
                    "description": "Service to accept payment using virtual account number from multiple banks",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "b2e7fe6b-cbcc-43b4-8637-3580492d7e53",
                    "status": "ACTIVE"
                },
                {
                    "id": "PRD-0143-1678960841365",
                    "code": "CREDIT_CARD_AGGREGATOR",
                    "name": "Credit Card (Partner Agregator)",
                    "description": "Accept payments using credit cards. This service is processed using DOKU's MID registered with the acquiring bank.",
                    "rejected": false,
                    "notified": true,
                    "approval_uuid": "ac9f554a-439c-459c-a912-15c6fdcbabe1",
                    "status": "ACTIVE"
                }
            ],
            "audit_logs": [],
            "authorized": true,
            "rejected": false,
            "notified": true,
            "approval_uuid": "3e07befa-6657-448c-aae5-09c6e3d02b6c",
            "status": "UPDATING",
            "description": "Description test untuk brand",
            "created_date": "2023-03-16T10:00:41Z"
        }
    ],
    "contacts": [
        {
            "id": "CNT-0112-1678960841579",
            "name": "contact jasmine under partner ke 2",
            "email": "[email protected]",
            "phone_calling_code": "62",
            "phone_number": "8191029",
            "liveness_image": "https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0104-1678960841263/OWNER_LIVENESS/DEFAULT/1678960841685.jpeg?Expires=1742713187&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=%2BjwpuMGe1gX8YYNWCdGgAbCF6aw%3D",
            "position": {
                "code": "OWNER",
                "name": "Owner"
            },
            "nationality": {
                "code": "ID",
                "name": "Indonesia"
            },
            "liveness_factor": {
                "code": "SHOW_TWO",
                "name": "show number 2 with finger without covering your face"
            },
            "use_primary": true,
            "rejected": false,
            "notified": true,
            "approval_uuid": "6f4a42b4-d078-4712-b950-51aa284744a6",
            "status": "UPDATING"
        }
    ],
    "addresses": [
        {
            "id": "ADR-0111-1678960841481",
            "name": "Jalan raya kaliabang tengah no 78, bekasi utara",
            "area": {
                "code": "17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat"
            },
            "country": {
                "code": "ID",
                "name": "Indonesia"
            },
            "use_primary": true,
            "rejected": false,
            "notified": true,
            "approval_uuid": "f4b11369-927f-4b52-a76a-3b45ec44b164",
            "status": "UPDATING"
        }
    ],
    "documents": [
        {
            "id": "DCM-0117-1678960841601",
            "relation": "CNT-0112-1678960841579",
            "link": "https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0104-1678960841263/DOCUMENT/CNT-0112-1678960841579/KTP/DCM-0117-1678960841601/1678960841604.jpg?Expires=1742713187&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=sx7Z2w0r50Ktk3P%2BgH5b%2FzSauEE%3D",
            "document": {
                "code": "KTP",
                "name": "Kartu Tanda Penduduk"
            },
            "forms": [
                {
                    "code": "NO_KTP",
                    "name": "KTP No. (NIK)",
                    "value": "1234567890123456"
                }
            ],
            "rejected": false,
            "notified": true,
            "approval_uuid": "21d836d9-345b-4b20-989b-993469d7ec87",
            "status": "UPDATING"
        }
    ],
    "banks": [
        {
            "id": "BNK-0103-1678960841495",
            "bank_id": "4",
            "bank_name": "BANK BCA",
            "swift_code": "014",
            "account_name": "Jasmine Test QA",
            "account_number": "12345058",
            "documents": [],
            "country": {
                "code": "ID",
                "name": "Indonesia"
            },
            "currency": {
                "code": "IDR",
                "name": "Indonesian rupiah"
            },
            "rejected": false,
            "notified": true,
            "approval_uuid": "1c6d3599-51ec-406a-8cfb-fd6b96a8269a",
            "status": "UPDATING"
        }
    ],
    "step_number": 10,
    "rejected": false,
    "notified": true,
    "approval_uuid": "0fe9de0c-1879-4a32-a6a1-935043a2c648",
    "status": "UPDATING"
}

CORPORATE

Response Explanation

PERSONAL

Parameter	Data Type	Possible Value
id	ANS(22)	BSN-0102-1676676916608
name	ANS(225)	Business under partner personal to check partner identifier CRM
description	ANS(255)	Description test untuk personal partner CRM DOKU
email	ANS(30)	[email protected]
phone_calling_code	ANS(320)	62
phone_number	ANS(320)	815107283011
partner	ANS(22)	BRN-0201-1676357010382
platform	ANS(255)	api
type	ANS(22)	PERSONAL
website_readiness.code	ANS(22)	HAVE
website_readiness.value	ANS(22)	Have a website
mobile_app_readiness.code	ANS(255)	UNDER_DEVELOPMENT
mobile_app_readiness.value	ANS(22)	Under Development
legal_entity.code	ANS(22)	PERSEORANGAN
legal_entity.name	ANS(255)	Personal
brands.id	ANS(50)	BRN-0104-1678960841263
brands.name	ANS(22)	Brand under partner personal only test
brands.share_key	ANS(255)	SK-ViEeAojc5K0nBrL41ou4
brands.category	ANS(255)	NON_RETAIL
brands.minimum_transaction	ANS(10)	0
brands.maximum_transaction	ANS(255)	100
brands.transaction_frequency.code	ANS(255)	UMI
brands.transaction_frequency.name	ANS(10)	< IDR 20 Mio
brands.transaction_quantity.code	ANS(10)	UP_TO_100
brands.transaction_quantity.name	ANS(10)	< 100
brands.ticket_size.code	ANS(10)	UP_TO_50K
brands.ticket_size.name	ANS(50)	Less than or equal to IDR 50.000
brands.finance_status	ANS(50)	PROBATION
brands.risk_engine_status	ANS(50)	ON_PROCESS
brands.photo_proofs.id	ANS(50)	PHP-0113-1678960841279
brands.photo_proofs.photo	ANS(255)	https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0104-1678960841263/PHOTO_PROOF/BRN-0104-1678960841263/1678960841281.jpeg?Expires=1742956083&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=ryZ%2FFypKVw6025A17ktRjLiqwEs%3D
brands.photo_proofs.rejected	boolean	false
brands.photo_proofs.notified	boolean	true
brands.photo_proofs.approval_uuid	AN(128)	7e90d35b-dae6-40cb-9aae-6effdec3f3ac
brands.photo_proofs.status	ANS(50)	UPDATING
brands.social_media.id	AN(128)	SCM-0108-1678960841279
brands.social_media.code	ANS(50)	FACEBOOK
brands.social_media.name	ANS(50)	Facebook
brands.social_media.account	ANS(50)	https://www.facebook.com/dokuid
brands.social_media.rejected	boolean	false
brands.social_media.notified	boolean	true
brands.social_media.approval_uuid	AN(128)	0932625e-8e04-44c3-bb37-36279559e7c0
brands.social_media.status	ANS(50)	UPDATING
brands.products.id	AN(128)	PRD-0138-1678960841304
brands.products.code	ANS(50)	ONLINE_TO_OFFLINE_ALFA_AGGREGATOR
brands.products.name	ANS(50)	Alfa Group (Aggregator)
brands.products.description	ANS(255)	Accept payments at Alfamart, Alfamidi, Dan+Dan, and Lawson outlets. Your customer will make payment using DOKU's name.
brands.products.rejected	boolean	false
brands.products.notified	boolean	true
brands.products.approval_uuid	AN(128)	5b4e4539-042e-4c27-a71b-cb8d6d4ddd0f
brands.products.status	ANS(50)	ACTIVE
brands.audit_logs		[[]]
brands.authorized	boolean	true
brands.rejected	boolean	false
brands.notified	boolean	true
brands.approval_uuid	AN(128)	3e07befa-6657-448c-aae5-09c6e3d02b6c
brands.status	ANS(50)	UPDATING
brands.description	ANS(255)	Description test untuk brand
brands.created_date	date	2023-03-16T10:00:41Z
contacts.id	AN(128)	CNT-0112-1678960841579
contacts.name	ANS (50)	contact jasmine under partner ke 2
contacts.email	ANS (50)	[email protected]
contacts.phone_calling_code	Numeric	62
contacts.phone_number	Numeric	8191029
contacts.liveness_image	AN(128)	https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0104-1678960841263/OWNER_LIVENESS/DEFAULT/1678960841685.jpeg?Expires=1742956083&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=z9jnEProlT9KupZftEVZeJWqrwk%3D
contacts.position.code	ANS (50)	OWNER
contacts.position.name	ANS (50)	Owner
contacts.nationality.code	ANS (10)	ID
contacts.nationality.name	ANS (10)	Indonesia
contacts.liveness_factor.code	ANS (10)	SHOW_TWO
contacts.liveness_factor.name	ANS (50)	show number 2 with finger without covering your face
contacts.use_primary	boolean	true
contacts.rejected	boolean	false
contacts.notified	boolean	true
contacts.approval_uuid	AN(128)	6f4a42b4-d078-4712-b950-51aa284744a6
contacts.status	ANS (50)	UPDATING
addresses.id	AN(128)	ADR-0111-1678960841481
addresses.name	ANS (255)	Jalan raya kaliabang tengah no 78, bekasi utara
addresses.area.code	ANS (50)	17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat
addresses.country.code	ANS (10)	ID
addresses.country.name	ANS (50)	Indonesia
addresses.use_primary	boolean	true
addresses.rejected	boolean	false
addresses.notified	boolean	true
addresses.approval_uuid	AN(128)	f4b11369-927f-4b52-a76a-3b45ec44b164
addresses.status	ANS (50)	UPDATING
documents.id	AN(128)	DCM-0117-1678960841601
documents.relation	AN(128)	CNT-0112-1678960841579
documents.link	AN(128)	https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0104-1678960841263/DOCUMENT/CNT-0112-1678960841579/KTP/DCM-0117-1678960841601/1678960841604.jpg?Expires=1742956083&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=F9vurvuHYZpV63LdkzDj9yFuGcQ%3D
documents.document.code	ANS(50)	KTP
documents.document.name	ANS(50)	Kartu Tanda Penduduk
documents.forms.code	ANS(10)	NO_KTP
documents.forms.name	ANS(50)	KTP No. (NIK)
documents.forms.value	Numeric	1234567890123456
documents.rejected	boolean	false
documents.notified	boolean	true
documents.approval_uuid	AN(128)	21d836d9-345b-4b20-989b-993469d7ec87
documents.status	ANS (50)	UPDATING
banks.id	AN (128)	BNK-0103-1678960841495
banks.bank_id	AN(128)	4
banks.bank_name	AN(128)	BANK BCA
banks.swift_code	AN(128)	014
banks.account_name	ANS (50)	Jasmine Test QA
banks.account_number	AN(128)	12345058
banks.documents		[[]]
banks.country.code	ANS (50)	ID
banks.country.name	ANS (50)	Indonesia
banks.currency.code	ANS (50)	IDR
banks.currency.name	ANS (50)	Indonesian rupiah
banks.rejected		false
banks.notified		true
banks.approval_uuid	ANS (50)	1c6d3599-51ec-406a-8cfb-fd6b96a8269a
banks.status	ANS (50)	UPDATING
step_number	AN(128)	10
rejected		false
notified		true
approval_id	AN(128)	0fe9de0c-1879-4a32-a6a1-935043a2c648
status	ANS (50)	UPDATING

Response Example (JSON)

CORPORATE