rdl-registration

To register, you will need to hit this API through your Backend:

API Request

Type	Value
HTTP Method	POST
API endpoint (Sandbox)	https://api-sandbox.doku.com/sac-rdl/v1/rdl-customers
API endpoint (Production)	https://api.doku.com/sac-rdl/v1/rdl-customers

Here is the sample of request header to create the payment:

Client-Id: MCH-0001-10791114622547
Request-Id: b6a465ea-bb65-48b2-a22b-3e8fb51cf22e
Request-Timestamp: 2020-08-11T08:45:42Z
Signature: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=

Request Header Explanation

Parameter	Description
Client-Id	Client ID retrieved from DOKU Back Office
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

Here is the sample of request body for RDL Registration:

{
    "rdl_customer": {
        "customer_id": "INVESTOR-0000100001",
        "customer_name": "SEMAR DUADUA",
        "address_city": "Kota Bandung",
        "address_kecamatan": "Buah Batu",
        "address_kelurahan": "Margasari",
        "address_province": "Jawa Barat",
        "address_rt_rw": "10/10",
        "address_street": "Jl. Jalan",
        "birth_date": "1989-09-01",
        "birth_place": "Jakarta",
        "education": "STRATA_SATU",
        "email": "duadua@doku.com",
        "gender": "FEMALE",
        "home_phone_number": "0810101011",
        "id_expiry_date": "2099-10-10",
        "id_number": "1000000000000000",
        "npwp_number" : "0111111111111111",
        "job_code": "ENTREPRENEUR",
        "marital_status": "MARRIED",
        "mobile_phone_number": "0851231231",
        "monthly_income": "1",
        "mother_maiden_name": "mymom",
        "nationality": "ID",
        "office_phone_number": "02112311",
        "religion": "ISLAM",
        "resident_status": "R",
        "source_of_fund": "SALARY",
        "zip_code": "40286",
        "title": "MS",
        "open_account_reason": "INVESTMENT",
        "selfie_photo": "(Base64)"
    }
}

Request Body Explanation

Parameter	Type	Mandatory	Description
rdl_customer.customer_id	string	Mandatory	Unique ID of the investor provide by merchant Max Length: 100
rdl_customer.customer_name	string	Mandatory	Investor's full name Max Length: 100
rdl_customer.address_city	string	Mandatory	City, you can refer to List Of City Max Length: 50
rdl_customer.address_kecamatan	string	Mandatory	District (kecamatan) where Investor lives Max Length: 50
rdl_customer.address_kelurahan	string	Mandatory	Sub-District (kelurahan) where Investor lives Max Length: 50
rdl_customer.address_province	string	Mandatory	Province (provinsi) where Investor lives Max Length: 50
rdl_customer.address_rt_rw	string	Mandatory	RT/RW where Investor lives Max Length: 50
rdl_customer.address_street	string	Mandatory	Street address where Investor lives Max Length: 100
rdl_customer.birth_date	date	Mandatory	Investor's birth date
rdl_customer.birth_place	string	Mandatory	Investor's birth place Max Length: 100
rdl_customer.education	string	Mandatory	Education, you can refer to List Of Education Max Length: 20
rdl_customer.email	string	Mandatory	Investor's email Max Length: 40
rdl_customer.gender	string	Mandatory	Investor's gender Max Length: 5
rdl_customer.home_phone_number	string	Optional	Investor's home phone number Max Length: 15
rdl_customer.id_expiry_date	date	Mandatory	Investor's ID Expired date
rdl_customer.id_number	string	Mandatory	Investor's ID number Max Length: 50
rdl_customer.npwp_number	string	Mandatory	Investor's NPWP number Max Length: 50
rdl_customer.job_code	string	Mandatory	Job Code, you can refer to List Of Job Code Max Length: 50
rdl_customer.marital_status	string	Mandatory	Marital Status, you can refer to List Of Marital Status Max Length: 10
rdl_customer.mobile_phone_number	string	Mandatory	Investor's phone number Max Length: 15
rdl_customer.monthly_income	number	Mandatory	Monthly Income, you can refer to List Of Monthly Income Max Length: 2
rdl_customer.mother_maiden_name	string	Mandatory	Investor's mother maiden name Max Length: 50
rdl_customer.nationality	string	Mandatory	Investor's nationality in ISO for country code Max Length: 2
rdl_customer.office_phone_number	string	Optional	Investor's office phone number Max Length: 15
rdl_customer.religion	string	Optional	Religion, you can refer to List Of Religion Max Length: 15
rdl_customer.resident_status	string	Mandatory	Investor's resident status Max Length: 2
rdl_customer.source_of_fund	string	Mandatory	Source of fund Max Length: 20
rdl_customer.zip_code	string	Mandatory	Investor's Zip Code Max Length: 5
rdl_customer.title	string	Mandatory	Title, you can refer to List Of Title Max Length: 3
rdl_customer.open_account_reason	string	Mandatory	Reason, you can refer to List Of Reason Max Length: 15
rdl_customer.selfie_photo	varchar	Mandatory	Investor's selfie photo encoded with base64

API Response

After hitting the above API request, DOKU will give the response.

Type	Value
HTTP Status	201
Result	CREATED

Here is the sample response header:

Client-Id: MCH-0001-10791114622547
Request-Id: b6a465ea-bb65-48b2-a22b-3e8fb51cf22e
Response-Timestamp: 2020-08-11T08:45:42Z
Signature: HMACSHA256=1jap2tpgvWt83tG4J7IhEwUrwmMt71OaIk0oL0e6sPM=

Response Header Explanation

Parameter	Description
Client-Id	Same as the request
Request-Id	Same as the request
Response-Timestamp	Timestamp Response on UTC with format ISO8601 UTC+0 from DOKU
Signature	Signature generated by DOKU based on the response body

Here is the sample of response body:

{
    "rdl_customer": {
        "customer_id": "INVESTOR-0000100001",
        "birth_place": "Jakarta",
        "birth_date": "1989-09-01",
        "gender": "FEMALE",
        "marital_status": "MARRIED",
        "nationality": "ID",
        "resident_status": "R",
        "religion": "ISLAM",
        "education": "STRATA_SATU",
        "mother_maiden_name": "mymom",
        "address_street": "Jl. Jalan",
        "address_rt_rw": "10/10",
        "address_kelurahan": "Margasari",
        "address_kecamatan": "Buah Batu",
        "address_city": "Kota Bandung",
        "address_province": "Jawa Barat",
        "zip_code": "40286",
        "mobile_phone_number": "0851231231",
        "office_phone_number": "02112311",
        "home_phone_number": "0810101011",
        "id_number": "1000000000000000",
        "id_expiry_date": "2099-10-10",
        "job_code": "ENTREPRENEUR",
        "monthly_income": 1,
        "source_of_fund": "SALARY",
        "title": "MS",
        "open_account_reason": "INVESTMENT",
        "npwp_number": "0111111111111111",
        "company_id": "DOKU",
        "account_id": 2340220322154948265107180133830000142742,
        "customer_name": "SEMAR DUADUA"
    },
    "rdl_customer_info": {
        "account_balance": 0,
        "RDL_status": "PENDING"
    }
}

Response Body Explanation

Parameter	Type	Mandatory	Description
rdl_customer.customer_id	string	Mandatory	Unique ID of the investor provide by merchant
rdl_customer.customer_name	string	Mandatory	Investor's full name
rdl_customer.address_city	string	Mandatory	City
rdl_customer.address_kecamatan	string	Mandatory	District (kecamatan) where Investor lives
rdl_customer.address_kelurahan	string	Mandatory	Sub-District (kelurahan) where Investor lives
rdl_customer.address_province	string	Mandatory	Province (provinsi) where Investor lives
rdl_customer.address_rt_rw	string	Mandatory	RT/RW where Investor lives
rdl_customer.address_street	string	Mandatory	Street address where Investor lives
rdl_customer.birth_date	date	Mandatory	Investor's birth date
rdl_customer.birth_place	string	Mandatory	Investor's birth place
rdl_customer.education	string	Mandatory	Education
rdl_customer.email	string	Mandatory	Investor's email
rdl_customer.gender	string	Mandatory	Investor's gender
rdl_customer.home_phone_number	string	Optional	Investor's home phone number
rdl_customer.id_expiry_date	date	Mandatory	Investor's ID Expired date
rdl_customer.id_number	string	Mandatory	Investor's ID number
rdl_customer.npwp_number	string	Mandatory	Investor's NPWP numberInvestor's NPWP number
rdl_customer.job_code	string	Mandatory	Job Code
rdl_customer.marital_status	string	Mandatory	Marital Status
rdl_customer.mobile_phone_number	string	Mandatory	Investor's phone number
rdl_customer.monthly_income	number	Mandatory	Monthly Income
rdl_customer.mother_maiden_name	string	Mandatory	Investor's mother maiden name
rdl_customer.nationality	string	Mandatory	Investor's nationality in ISO for country code
rdl_customer.office_phone_number	string	Optional	Investor's office phone number
rdl_customer.religion	string	Optional	Religion
rdl_customer.resident_status	string	Mandatory	Investor's resident status
rdl_customer.source_of_fund	string	Mandatory	Source of fund
rdl_customer.zip_code	string	Mandatory	Investor's Zip Code
rdl_customer.title	string	Mandatory	Title
rdl_customer.open_account_reason	string	Mandatory	Reason
rdl_customer.company_id	string	Mandatory	Investor's company id
rdl_customer.account_id	string	Mandatory	Investor's account id provide by DOKU
rdl_customer_info.account_balance	number	Mandatory	Investor's account balance
rdl_customer_info.RDL_status	string	Mandatory	Investor's RDL account status