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

POSThttps://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account

Header parameters

Body

application/json

Request Register Bank Account

bank_account*bank_account (object)

Response

200401404

settlement bank account created

Body

application/json

bank_account*bank_account_response (object)

Request

JavaScriptCurlPython

const response = await fetch('https://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account', {
    method: 'POST',
    headers: {
      "Client-Id": "text",
      "Request-Id": "text",
      "Request-Timestamp": "text",
      "Signature": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "bank_account": {
        "code": "008",
        "number": 1081214141456,
        "name": "Test edwin",
        "currency": "IDR",
        "country": "Indonesia"
      }
    }),
});
const data = await response.json();

Response

200401404

{
  "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

update settlement bank account

PUThttps://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account

Header parameters

Body

application/json

Request Update Bank Account

bank_account*bank_account (object)

Response

200400404409

settlement bank account update

Body

application/json

bank_account*bank_account_response (object)

Request

JavaScriptCurlPython

const response = await fetch('https://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account', {
    method: 'PUT',
    headers: {
      "Client-Id": "text",
      "Request-Id": "text",
      "Request-Timestamp": "text",
      "Signature": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "bank_account": {
        "code": "008",
        "number": 1081214141456,
        "name": "Test edwin",
        "currency": "IDR",
        "country": "Indonesia"
      }
    }),
});
const data = await response.json();

Response

200404

{
  "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

check status settlement bank account

GEThttps://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account/{bank_account_settlement_id}

Path parameters

bank_account_settlement_id*string

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

Example: "SBS-4325345345-4353463456"

Header parameters

Response

200400404409

check status settlement bank account

Body

application/json

bank_account*bank_account_response (object)

Request

JavaScriptCurlPython

const response = await fetch('https://{sandbox/production.doku.com}.com/fc-h2h-api/v2/settlement-bank-account/{bank_account_settlement_id}', {
    method: 'GET',
    headers: {
      "Client-Id": "text",
      "Request-Id": "text",
      "Request-Timestamp": "text",
      "Signature": "text"
    },
});
const data = await response.json();

Response

200404

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