Create Business Lite API

Unlike the Create Business 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

TypeValue

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=
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": {
    "partner_ref_id": "13aa67f8-c2ac-437c-9eb5-e5b1934fbfcc",
    "name": "John Store",
    "contact": {
      "name": "John Michael",
      "email": "john@gmail.com",
      "phone_calling_code": "62",
      "phone_number": "81510229216"
    }
  },
  "referral": {
    "code": "ABC123"
  },
  "invited_user": {
    "email": "string"
  }
}
Query ParamsTypeMandatoryDescription

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"
            }
        ]
    }
}
ParameterTypeDescription

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

Last updated