File Requirements API

Endpoint

Type	Value
HTTP Method	GET
API endpoint (Test Mode)	https://api-uat.doku.com/adv-core-api/partner/v1.0/file
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

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": {
        "brand": {
            "photo_proof": {
                "code": "PHOTO_PROOF",
                "name": "Brand Photo Proof",
                "extensions": [
                    "PNG",
                    "JPG",
                    "JPEG"
                ],
                "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)"
                        }
                    ]
                }
            ],
            "owner_liveness": {
                "code": "OWNER_LIVENESS",
                "name": "Owner Liveness",
                "extensions": [
                    "PNG",
                    "JPG",
                    "JPEG"
                ],
                "max_size": 15
            }
        }
    }
}

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