Bulk Registration Bank

This feature will enable merchant to manage settlement bank account via host to host protocol

The feature needs to be activated before merchants can start to use the feature. Please see steps listed below :

1. Activate Bulk Registration Bank Features

2. API for Settlement Bank Account

   1. Create Settlement Bank Account

   2. Update Settlement Bank Account

   3. Get Settlement Bank Account

Activate Bulk Registration Bank Features

This feature will enable merchant to create, edit, and get settlement bank account in bulk via H2H API. Due to safety consideration, merchant have to enabling manually after finished onboarding.

Steps to enable the feature as follows :

1. Login to DOKU dashboard

2. Go to menu Setting > Service

1. Click "Add Service" button

2. Under menu of "Financial Service", choose Others

3. Check "Bulk Registration Bank" option

4. Saved by click button Activate

5. Click document icon to download "Surat Instruksi Pelimpahan Dana" template document to be filled in

6. Upload "Surat Instruksi Pelimpahan Dana" in PDF format

7. After document successfully uploaded, click "Activate" button.

8. The service will be successfully send. You can click "OK" button

API for Settlement Bank Account

This is a documentation for host-to-host API Bank Account.

1. Create Settlement Bank Account

To create settlement bank account, you will need to hit this API through your Backend :

create settlement bank account

post

create settlement bank account

Header parameters

Client-IdstringRequired

Client ID retrieved from DOKU Back Office

Example: MCH-0001-10791114622547

Request-IdstringRequired

Unique random string (max 128 characters) generated from merchant side to protect duplicate request

Example: b6a465ea-bb65-48b2-a22b-3e8fb51cf22e

Request-TimestampstringRequired

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

Example: 2020-08-11T08:45:42Z

SignaturestringRequired

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

Example: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=

Body

application/json

Responses

200

settlement bank account created

application/json

401

Unauthorized Access

application/json

404

swift code not found

application/json

post

/v2/settlement-bank-account

HTTPcURLJavaScriptPython

POST /production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account HTTP/1.1
Host: {sandbox/production.doku.com}.com/fc-h2h-api
Client-Id: text
Request-Id: text
Request-Timestamp: text
Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "bank_account": {
    "code": "008",
    "number": 1081214141456,
    "name": "Test edwin",
    "currency": "IDR",
    "country": "Indonesia"
  }
}

{
  "bank_account": {
    "code": "008",
    "number": 1081214141456,
    "name": "edwin",
    "currency": "IDR",
    "country": "ID",
    "status": "VERIFIED",
    "bank_account_settlement_id": "SBA-0101023-11"
  }
}

2. Update Settlement Bank Account

Update settlement bank account only able for data in “verified” state. To update settlement bank account, you will need to hit this API through your Backend:

update settlement bank account

put

update settlement bank account

Header parameters

Client-IdstringRequired

Client ID retrieved from DOKU Back Office

Example: MCH-0001-10791114622547

Request-IdstringRequired

Unique random string (max 128 characters) generated from merchant side to protect duplicate request

Example: b6a465ea-bb65-48b2-a22b-3e8fb51cf22e

Request-TimestampstringRequired

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

Example: 2020-08-11T08:45:42Z

SignaturestringRequired

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

Example: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=

Body

application/json

Responses

200

settlement bank account update

application/json

400

invalid input, object invalid

404

settlement bank account created

application/json

409

an existing item already exists

put

/v2/settlement-bank-account

HTTPcURLJavaScriptPython

PUT /production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account HTTP/1.1
Host: {sandbox/production.doku.com}.com/fc-h2h-api
Client-Id: text
Request-Id: text
Request-Timestamp: text
Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "bank_account": {
    "code": "008",
    "number": 1081214141456,
    "name": "Test edwin",
    "currency": "IDR",
    "country": "Indonesia"
  }
}

{
  "bank_account": {
    "code": "008",
    "number": 1081214141456,
    "name": "edwin",
    "currency": "IDR",
    "country": "ID",
    "status": "VERIFIED",
    "bank_account_settlement_id": "SBA-0101023-11"
  }
}

3. Get Settlement Bank Account

To get settlement bank account, you will need to hit this API through your Backend :

check status settlement bank account

get

check status settlement bank account

Path parameters

bank_account_settlement_idstringRequired

Bank code generated by DOKU. The code will be reference when merchant want to do split settlement

Example: SBS-4325345345-4353463456

Header parameters

Client-IdstringRequired

Client ID retrieved from DOKU Back Office

Example: MCH-0001-10791114622547

Request-IdstringRequired

Unique random string (max 128 characters) generated from merchant side to protect duplicate request

Example: b6a465ea-bb65-48b2-a22b-3e8fb51cf22e

Request-TimestampstringRequired

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

Example: 2020-08-11T08:45:42Z

SignaturestringRequired

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

Example: HMACSHA256=vl9DBTX5KhEiXmnpOD0TSm8PYQknuHPdyHSTSc3W6Ps=

Responses

200

check status settlement bank account

application/json

400

invalid input, object invalid

404

settlement bank account created

application/json

409

an existing item already exists

get

/v2/settlement-bank-account/{bank_account_settlement_id}

HTTPcURLJavaScriptPython

GET /production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account/{bank_account_settlement_id} HTTP/1.1
Host: {sandbox/production.doku.com}.com/fc-h2h-api
Client-Id: text
Request-Id: text
Request-Timestamp: text
Signature: text
Accept: */*

{
  "bank_account": {
    "code": "008",
    "number": 1081214141456,
    "name": "edwin",
    "currency": "IDR",
    "country": "ID",
    "status": "VERIFIED",
    "bank_account_settlement_id": "SBA-0101023-11"
  }
}