DOKU DocsChangelogDOKU Github

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

Parameter
Possible Values

businessType

PERSONAL

businessLegalEntity

PERSEORANGAN

brandBusinessLine

  • RETAIL

businessContactNationality

ID

Response Sample

{
    "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"
}

Response Explanation

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)

PreviousCreate Business Lite APINextKirim DOKU

Last updated

Was this helpful?