Bulk Settlement

This feature will enable merchant to manage settlement bank account in bulk via H2H API

To start integrate feature of bulk settlement through host-to-host API, here is the steps :

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 Account > Service

3. Click "tambah layanan/add service" button

4. Under menu of "layanan financial/financial service", choose lainnya

5. Check "bulk registration bank" option

6. Saved by click button "aktifkan/activate"

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

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

9. After document successfully uploaded, click "Aktifkan" button.

10. 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

PUThttps://virtserver.swaggerhub.com/DOKUTECHNOLOGY/fc-h2h-api/1.0.0/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

JavaScriptCurl

const response = await fetch('https://virtserver.swaggerhub.com/DOKUTECHNOLOGY/fc-h2h-api/1.0.0/v2/settlement-bank-account', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "bank_account": {
        "code": "008",
        "number": 1081214141456,
        "name": "Test edwin",
        "currency": "IDR",
        "country": "ID"
      }
    }),
});
const data = await response.json();

Response

{
  "bank_account": {
    "code": "008",
    "number": 1081214141456,
    "name": "Test 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

POSThttps://virtserver.swaggerhub.com/DOKUTECHNOLOGY/fc-h2h-api/1.0.0/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

JavaScriptCurl

const response = await fetch('https://virtserver.swaggerhub.com/DOKUTECHNOLOGY/fc-h2h-api/1.0.0/v2/settlement-bank-account', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "bank_account": {
        "code": "008",
        "number": 1081214141456,
        "name": "Test edwin",
        "currency": "IDR",
        "country": "ID"
      }
    }),
});
const data = await response.json();

Response

{
  "bank_account": {
    "code": "008",
    "number": 1081214141456,
    "name": "Test 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://virtserver.swaggerhub.com/DOKUTECHNOLOGY/fc-h2h-api/1.0.0/v2/settlement-bank-account/{bank_account_settlement_id}

Path parameters

bank_account_settlement_id*string

settlement bank account id

Header parameters

Response

200400404409

check status settlement bank account

Body

application/json

bank_account*bank_account_response (object)

Request

JavaScriptCurl

const response = await fetch('https://virtserver.swaggerhub.com/DOKUTECHNOLOGY/fc-h2h-api/1.0.0/v2/settlement-bank-account/{bank_account_settlement_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

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