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

create settlement bank account

post

/v2/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

bank_accountobjectrequired

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account' \
  --header 'Client-Id: text' \
  --header 'Request-Id: text' \
  --header 'Request-Timestamp: text' \
  --header 'Signature: text' \
  --header 'Content-Type: application/json' \
  --data '{"bank_account":{"code":"008","number":1081214141456,"name":"Test edwin","currency":"IDR","country":"Indonesia"}}'

200

401

404

200

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

settlement bank account created

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

update settlement bank account

put

/v2/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

bank_accountobjectrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account' \
  --header 'Client-Id: text' \
  --header 'Request-Id: text' \
  --header 'Request-Timestamp: text' \
  --header 'Signature: text' \
  --header 'Content-Type: application/json' \
  --data '{"bank_account":{"code":"008","number":1081214141456,"name":"Test edwin","currency":"IDR","country":"Indonesia"}}'

200

400

404

409

200

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

settlement bank account update

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

check status settlement bank account

get

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

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

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account/{bank_account_settlement_id}' \
  --header 'Client-Id: text' \
  --header 'Request-Id: text' \
  --header 'Request-Timestamp: text' \
  --header 'Signature: text'

200

400

404

409

200

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

check status settlement bank account