Create Business API

Endpoint

Type	Value
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=

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

PERSONAL

{
  "business": {
    "type": "PERSONAL",
    "legal_entity": "PERSEORANGAN",
    "name": "Merona Store XXIV",
    "email": "[e-mail]",
    "phone_calling_code": "62",
    "phone_number": "812341234",
    "brands": [
      {
        "name": "Merona Store XXIV",
        "category": "RETAIL",
        "description": "Menjual peralatan dan dekorasi pesta",
        "social_media": [
          {
            "accounts": [
              "https://www.instagram.com/merona.store"
            ],
            "code": "INSTAGRAM"
          },
          {
            "accounts": [
              "https://www.facebook.com/meronastorexxiv"
            ],
            "code": "FACEBOOK"
          }
        ],
        "photo_proofs": [
          {
            "id": "DCM-0142-1704845842852"
          }
        ]
      }
    ],
    "contacts": [
      {
        "documents": [
          {
            "code": "KTP",
            "category": "DOCUMENT",
            "id": "DCM-0143-1704846563431",
            "forms": [
              {
                "code": "NO_KTP",
                "value": "1234567890123456"
              }
            ]
          }
        ],
        "email": "[e-mail]",
        "name": "Gilang Prasetyo",
        "nationality": "ID",
        "phone_calling_code": "62",
        "phone_number": "8123123",
        "position": "OWNER",
        "primary": true,
        "owner_liveness": {
          "id": "CNT-0126-1704846646926"
        }
      }
    ],
    "addresses": [
      {
        "area": "17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat",
        "country": "ID",
        "name": "Jalan Raya Kali Tengah No 78",
        "primary": true
      }
    ],
    "banks": [
      {
        "account_name": "Gilang Prasetyo",
        "account_number": "12345058",
        "bank_id": "4",
        "bank_name": "BANK BCA",
        "country": "ID",
        "currency": "IDR",
        "swift_code": "014"
      }
    ]
  },
  "partner": {
    "invited_user": [
        "[e-mail]",
        "[e-mail]"
        ]
    }
}
}

Query Params	Type	Mandatory	Description
business.type	string(8)	Mandatory
business.legal_entity	string	Mandatory
business.name	string	Mandatory
business.email	string	Mandatory
business.calling_code	int(2)	Mandatory
business.phone_number	int(13)	Mandatory
business.brands.name			For PERSONAL, business.brands.name same as business.name e.g. Merona Store
business.brands.category			(Possible Values)
business.brands.description
business.addresses.area
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

CORPORATE

Possible Values

business.brands.category

Value	Description
RETAIL	Selling physical product
NON_RETAIL	Selling digital product or services

business.brands.category

• RETAIL

• NON RETAIL

PERSONAL

Parameter	Possible Values
businessType	PERSONAL
businessLegalEntity	PERSEORANGAN
businessContactNationality	ID

CORPORATE

Parameter	Possible Values
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

Response

PERSONAL

{
    "business": {
        "type": "PERSONAL",
        "name": "Merona Store XXIV",
        "email": "[e-mail]",
        "phone_calling_code": "62",
        "phone_number": "812341234",
        "id": "BSN-0112-1704851912067",
        "status": "UPDATING",
        "partner": "BRN-0249-1697537396783",
        "legal_entity": "PERSEORANGAN",
        "created_by": "BRN-0249-1697537396783",
        "is_partner": false,
        "brands": [
            {
                "id": "BRN-0116-1704851912072",
                "name": "Merona Store XXIV",
                "status": "UPDATING",
                "category": "RETAIL",
                "shared_key": "SK-vGUzXPM88tk51qMfXHRf",
                "transaction_frequency": "UKE",
                "transaction_quantity": "UP_TO_100",
                "social_media": [
                    {
                        "id": "SCM-0182-1704851912076",
                        "account": "https://www.instagram.com/merona.store",
                        "status": "UPDATING",
                        "name": "INSTAGRAM"
                    },
                    {
                        "id": "SCM-0183-1704851912079",
                        "account": "https://www.facebook.com/meronastorexxiv",
                        "status": "UPDATING",
                        "name": "FACEBOOK"
                    }
                ],
                "photo_proofs": [
                    {
                        "id": "PHP-0132-1704851912080",
                        "category": "PHOTO_PROOF",
                        "link": "https://cdn-dev.oss-ap-southeast-5.aliyuncs.com/adv-core-api/UAT/BSN-0112-1704851912067/PHOTO_PROOF/BRN-0116-1704851912072/1704851912080.png?Expires=1767923912&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=QpyA2SlCqQJ2SOyiJ8SUmUfr6mw%3D",
                        "status": "UPDATING"
                    }
                ],
                "services": [
                    {
                        "id": "PRD-0179-1704851912204",
                        "code": "ONLINE_TO_OFFLINE_ALFA_AGGREGATOR",
                        "name": "Alfa Group (Aggregator)",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0180-1704851912212",
                        "code": "DOKU_WALLET",
                        "name": "DOKU Wallet",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0181-1704851912215",
                        "code": "VIRTUAL_ACCOUNT",
                        "name": "Virtual Account (Multiple Banks)",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0182-1704851912219",
                        "code": "VIRTUAL_ACCOUNT_PARTNER_AGGREGATOR",
                        "name": "VA Aggregator (Multiple Banks)",
                        "status": "ACTIVE"
                    },
                    {
                        "id": "PRD-0183-1704851912223",
                        "code": "CREDIT_CARD_AGGREGATOR",
                        "name": "Credit Card (Partner Agregator)",
                        "status": "ACTIVE"
                    }
                ]
            }
        ],
        "contacts": [
            {
                "id": "CNT-0132-1704851912463",
                "name": "Gilang Prasetyo",
                "email": "[e-mail]",
                "phone_calling_code": "62",
                "phone_number": "8123123",
                "position": "OWNER",
                "nationality": "Indonesia",
                "primary": true,
                "documents": [
                    {
                        "id": "DCM-0150-1704851912468",
                        "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-0112-1704851912067/DOCUMENT/CNT-0132-1704851912463/KTP/DCM-0150-1704851912468/1704851912468.png?Expires=1767923912&OSSAccessKeyId=LTAI5tC4NMws75qhtQc3RbZs&Signature=ClRSkyKQz%2FhSbcsk6JKyGOfG59g%3D"
                    }
                ],
                "owner_liveness": {
                    "id": "CNT-0132-1704851912463",
                    "category": "OWNER_LIVENESS",
                    "link": "adv-core-api/UAT/BSN-0112-1704851912067/OWNER_LIVENESS/DEFAULT/1704851912541.png"
                }
            }
        ],
        "addresses": [
            {
                "name": "Jalan Raya Kali Tengah No 78",
                "area": "17133 - Kali Baru - Medan Satria - Bekasi - Jawa Barat",
                "country": "Indonesia",
                "primary": true
            }
        ],
        "banks": [
            {
                "account_name": "Gilang Prasetyo",
                "account_number": "12345058",
                "currency": "Indonesian rupiah",
                "bank_name": "BANK BCA",
                "overseas": false,
                "swift_code": "014",
                "country": "Indonesia"
            }
        ]
    }
}

Parameter	Type	Description
business.id
business.brands.id
business.brands.status
business.brands.shared_key

CORPORATE

{
    "business": {
        "brand": {
            "photo_proof": {
                "code": "PHOTO_PROOF",
                "name": "Brand Photo Proof",
                "extensions": [
                    "PNG",
                    "JPG",
                    "JPEG"
                ],
                "max_size": 15
            },
            "documents": [
                {
                    "code": "LISENSI_OJK",
                    "name": "Lisensi OJK (Otoritas Jasa Keuangan)",
                    "extensions": [
                        "PDF",
                        "JPG",
                        "JPEG",
                        "PNG"
                    ],
                    "max_size": 15
                },
                {
                    "code": "TANDA_DAFTAR_PSE",
                    "name": "Tanda Daftar Penyelenggara Sistem Elektronik dari Kementerian Komunikasi dan Informatika",
                    "extensions": [
                        "PDF",
                        "JPG",
                        "JPEG",
                        "PNG"
                    ],
                    "max_size": 15
                }
            ]
        },
        "contact": {
            "documents": [
                {
                    "code": "KTP",
                    "name": "Kartu Tanda Penduduk",
                    "extensions": [
                        "PDF",
                        "JPG",
                        "JPEG",
                        "PNG"
                    ],
                    "max_size": 15,
                    "form": [
                        {
                            "code": "NO_KTP",
                            "name": "No. KTP (NIK)",
                            "min_size": 16,
                            "max_size": 16,
                            "alpha": false,
                            "numeric": true,
                            "alpha_numeric": false,
                            "caption": "Masukkan 16 digit nomor KTP Anda (NIK)"
                        }
                    ]
                }
            ]
        },
        "documents": [
            {
                "code": "NPWP_BADAN",
                "name": "NPWP (Nomor Pokok Wajib Pajak) Badan",
                "extensions": [
                    "PDF",
                    "JPG",
                    "JPEG",
                    "PNG"
                ],
                "max_size": 15,
                "form": [
                    {
                        "code": "NO_NPWP",
                        "name": "No. NPWP",
                        "min_size": 15,
                        "max_size": 15,
                        "alpha": false,
                        "numeric": true,
                        "alpha_numeric": false,
                        "caption": "Masukkan 15 digit nomor NPWP Anda"
                    }
                ]
            },
            {
                "code": "SK_KEMENKUMHAM",
                "name": "Surat Keputusan Kementerian Hukum & HAM",
                "extensions": [
                    "PDF",
                    "JPG",
                    "JPEG",
                    "PNG"
                ],
                "max_size": 15
            },
            {
                "code": "NIB",
                "name": "NIB (Nomor Induk Berusaha)",
                "extensions": [
                    "PDF",
                    "JPG",
                    "JPEG",
                    "PNG"
                ],
                "max_size": 15,
                "form": [
                    {
                        "code": "NO_NIB",
                        "name": "No. NIB",
                        "min_size": 13,
                        "max_size": 13,
                        "alpha": false,
                        "numeric": true,
                        "alpha_numeric": false,
                        "caption": "Masukkan 13 digit nomor NIB Anda"
                    }
                ]
            },
            {
                "code": "IZIN_USAHA",
                "name": "Surat Izin Usaha",
                "extensions": [
                    "PDF",
                    "JPG",
                    "JPEG",
                    "PNG"
                ],
                "max_size": 15
            },
            {
                "code": "AKTA_PENDIRIAN_PERUSAHAAN",
                "name": "Akta Pendirian dan Perubahan Perusahaan",
                "extensions": [
                    "PDF",
                    "JPG",
                    "JPEG",
                    "PNG"
                ],
                "max_size": 25
            }
        ]
    }
}