Create Business Lite API

Unlike the Business Registration API where Partners can create a full business, this Create Business Lite API allows Partners to create a business by inviting users to complete their business data in DOKU Dashboard.

Endpoint

Type	Value
HTTP Method	POST
API endpoint (Test Mode)	https://api-uat.doku.com/adv-core-api/partner/v1.0/business/lite/registration
API endpoint (Production)	https://api.doku.com/adv-core-api/partner/v1.0/business/lite/registration

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

{
  "business": {
    "partner_ref_id": "13aa67f8-c2ac-437c-9eb5-e5b1934fbfcc",
    "name": "John Store",
    "contact": {
      "name": "John Michael",
      "email": "[email protected]",
      "phone_calling_code": "62",
      "phone_number": "81510229216"
    }
  },
  "referral": {
    "code": "ABC123"
  },
  "invited_user": {
    "email": "string"
  }
}

Query Params	Type	Mandatory	Description
business.partner_ref_id	string	Mandatory	Partner Reference ID
business.name	string	Mandatory	Business Name
business.contact.name	string	Mandatory	Business Representative Name
business.contact.email	string	Mandatory	Business Representative Email
business.contact.phone_calling_code	int(3)	Mandatory	Business Representative Phone Number Calling Code (ITU-T E.164)
business.contact.phone_number	int(13)	Mandatory	Business Representative Phone Number
referral.code	string(6)	Optional	Referral Code is generated by DOKU
invited_user.email	string	Mandatory	Emails that will be invited to complete the business onboarding

Response

{
    "business": {
        "id": "BSN-0103-1700206906468",
        "partner_ref_id": "PARTNER-TEST-MPE-JSM-171123.1",
        "brands": [
            {
                "id": "BRN-0103-1700206906471"
            }
        ]
    }
}

Parameter	Type	Description
business.id	string	Business ID (generated by DOKU)
business.partner_ref_id	string
brands.id	string	Brand ID (generated by DOKU) that will use for Direct API