DOKU DocsChangelogDOKU Github

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
Responses
200
settlement bank account created
application/json
post
POST /production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account HTTP/1.1
Host: {sandbox
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
Responses
200
settlement bank account update
application/json
put
PUT /production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account HTTP/1.1
Host: {sandbox
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
get
GET /production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account/{bank_account_settlement_id} HTTP/1.1
Host: {sandbox
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"
  }
}
PreviousHold and Release SettlementNextPostman Collection

Last updated

Was this helpful?