API Opening Account RDN v2.0

Buat API

API Information

Title

Opening Account RDN v2.0

Version

v2.0

URL Sandbox

https://sandbox.partner.api.bri.co.id

URL Production

  

Version Control

*fill in with version API and changes description

Example:

API Version

Date

Link dokument

Description

v2.0

18 Maret 2021

Halaman ini

Baseline version.

v2.0

31 Maret 2021

Halaman ini

Penambahan Header "BRI-External-ID"

v2.0

1 April 2021

Halaman ini

Penambahan List Response Code

v2.0

8 Agustus 2021

Halaman ini

Penambahan flow Opening Account RDN

Product Description

Product Overview

Service berikut digunakan untuk mengajukan pembukaan Rekening Dana Nasabah (RDN) dari Perusahaan Efek ke BRI

flow rdn

Endpoint

A. Request OTP

Endpoint Description

Service berikut digunakan untuk meminta kode OTP dan melakukan validasi nomor rekening dan nomor hp nasabah dari Perusahaan Efek ke BRI sebelum dilakukan pengajuan pembukaan Rekening Dana Nasabah (RDN)

General Information

HTTP Method POST
Path /v2.0/rdn/RequestOTPOpeningAccountRDN
Type Format JSON
Authentication OAuth 2.0 with Access Token

Header Structure

Key

Value

Mandatory

Length

Description

Example

Authorization

Bearer {token}

M

N/A

Access Token

 

BRI-Timestamp

 

M

-

ISO 8601 format. Timestamp must be in UTC or GMT +0 timezone.

2021-03-18T02:51:48.624Z

BRI-Signature

 

M

64

-

 

Content-Type

application/json

M

-

-

 

BRI-External-ID

Numeric

M

9

Unique

 

Request Structure

Field

Data Type

Mandatory

Length

Description

Example

acctNo

String

M

15

BRI account number that the customer had before

020601003892509

phoneNo

String

M

20

Cell phone number registered with BRI

08180792xxxx

partnerID

String

M

5

Unique code for each Securities Company

0D001

Response Structure

Field

Data Type

Mandatory

Length

Description

Example

responseCode

String

M

2

Response code

14

responseDescription

String

M

-

Response description

OTP requested succesfully

data

Object

M

-

JSON Object

-

errorMessage

String

M

6

Error Message

RD-200

otp

String

C

6

One Time Password

123456

registrationID

String

M

12

Unique ID for each submission

123456789012

Request and Response Payload Sample

Request :

{
   "acctNo":"020601003892509",
   "phoneNo":"085772333293",
   "partnerID":"0D001"
}

Normal Response :

{
   "responseCode":"00",
   "responseDescription":"OTP requested succesfully",
   "data":{
      "errorMessage":"RD-200",
      "otp":"489253",
      "registrationID":"023693307517"
   }
}

Erorr Response :

{
   "responseCode":"53",
   "responseDescription":"Nomor Rekening Tidak Dikenal",
   "data":{
      "errorMessage":"RD-053"
   }
}

List of Error/Response Code

HTTP Status

Error Message

Response Code

Status

Response Description

Description

200

RD-200

00

Sukses

OTP requested succesfully

 Request OTP sukses jika mendapat response RC 00

200

RD-053

53

Gagal

Unknown Account Number

 Request OTP gagal

200

RD-005

05

Gagal

Phone number not matched with account

 Request OTP gagal

200

RD-014

14

Gagal

Phone number not found

 Request OTP gagal

200

RD-028

14

Gagal

Partner ID or Branch not found

 Request OTP gagal

200

RD-999

99

Gagal

General error

 Request OTP gagal

200

RD-099

99

Gagal

 data cannot be null or blank

 

 Request OTP gagal

B. Opening Account

Endpoint Description

Service berikut digunakan untuk mengajukan pembukaan Rekening Dana Nasabah (RDN) dari Perusahaan Efek ke BRI yang sebelumnya sudah mempunyai data CIF di BRI.

General Information

HTTP Method

POST

Path

/v2.0/rdn/OpeningAccountRDN

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Header Structure

Key

Value

Mandatory

Length

Description

Example

Authorization

Bearer {token}

M

N/A

Access Token

 

BRI-Timestamp

 

M

-

ISO 8601 format. Timestamp must be in UTC or GMT +0 timezone.

2021-03-18T02:51:48.624Z

BRI-Signature

 

M

64

-

 

Content-Type

application/json

M

-

-

 

BRI-External-ID

Numeric

M

9

Unique

 

Request Structure

Field

Data Type

Mandatory

Length

Description

Example

registrationID

String

M

12

Unique ID for each submission

123456789012

partnerID

String

M

5

Unique code for each Securities Company

0D001

acctNo

String

M

5

BRI account number that the customer had before

02060100000xxxx

otp

String

M

15

One Time Password upon request

123456

sid

String

M

6

SID number from KSEI

IDD2707TY390527

sre

String

M

15

Securities sub account number from KSEI

OD001108A00151

branch

String

M

4

BRI branch office managing funds

0206

timestamp

String

M

 

TnC approval timestamp in the format: yyyy-MM-dd HH:mm:ss

2021-02-14 23:30:40

Response Structure

Field

Data Type

Mandatory

Length

Description

Example

responseCode

String

M

2

Response code

14

responseDescription

String

M

-

Response description

OTP requested succesfully

data

Object

M

-

JSON Object

-

errorMessage

String

M

6

Error Message

RD-200

registrationID

String

M

12

Unique ID for each submission

123456789012

Request and Response Payload Sample

Request :

        {
            "registrationID":"543112023666",
            "partnerID":"0D001",
            "acctNo":"020601003892509",
            "otp":"648246",
            "sid":"123456789012387",
            "sre":"12345678901239",
            "branch":"0206",
            "timestamp":"2021-02-1423:30:40"
        }

Normal Response :

        {
            "responseCode":"01",
            "responseDescription":"InvestorValidationdalamproses",
            "data":{
            "errorMessage":"RD-201",
            "registrationID":"123456789012"
            }
        }

Erorr Response :

        {
            "responsecode": "07",
            "responseDescription": "OTP tidak sesuai",
            "data": {
            "errorMessage": "RD-201"
            }
        }

List of Error/Response Code

HTTP Status

Error Message

Response Code

Status

Response Description

Description

200

RD-201

01

Sukses

Investor Validation in the process

Response success if you get RC 01

200

RD-006

06

Gagal

OTP does not match

Account opening request failed

200

RD-028

14

Gagal

Partner ID or Branch not found

Account opening request failed

200

RD-007

14

Gagal

Registration ID not registered or being processed

Account opening request failed

200

RD-999

99

Gagal

General error

Account opening request failed

C. Upload Doc

Endpoint Description

Service berikut digunakan untuk mengirimkan dokumen pengajuan pembukaan Rekening Dana Nasabah (RDN) oleh Perusahaan Efek ke BRI. Dokumen mandatory berupa KTP dan Tanda Tangan dalam format jpg dan dokumen optional berupa NPWP.

General Information

HTTP Method

POST

Path

/v2.0/rdn/UploadDoc

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Header Structure 

Key

Value

Mandatory

Length

Description

Example

Authorization

Bearer {token}

M

N/A

Access Token

 

BRI-Timestamp

 

M

-

ISO 8601 format. Timestamp must be in UTC or GMT +0 timezone.

2021-03-18T02:51:48.624Z

BRI-Signature

 

M

64

-

 

Content-Type

application/json

M

-

-

 

BRI-External-ID

Numeric

M

9

Unique

 

Request Structure

Field

Data Type

Mandatory

Length

Description

Example

registrationID

String

M

12

Unique ID for each submission

123456789012

partnerID

String

M

5

Unique code for each Securities Company

0D001

sid

String

M

15

SID number from KSEI

IDD2707TY390527

sre

String

M

14

Securities sub account number from KSEI

123456789112342

ktp

String

M

Max: 250KB

Customer ID card (.jpg)

Encrypted Base64

npwp

String

O

Max: 250KB

NPWP nasabah ( .jpg)

Encrypted Base64

signature

String

M

Max: 250KB

Customer signature (.jpg)

Encrypted Base64

formData

String

M

Max: 250KB

AR01 data in file form (.txt)

Encrypted Base64

form

String

M

Max: 250KB

File AR01 dalam format pdf

Encrypted Base64

Response Structure

Field

Data Type

Mandatory

Length

Description

Example

responseCode

String

M

2

Response code

14

responseDescription

String

M

-

Response description

OTP requested succesfully

data

Object

M

-

JSON Object

-

errorMessage

String

M

6

Error Message

RD-203

Request and Response Payload Sample

Request :

        {
            "registrationID":"113765099643",
            "partnerID":"0D001",
            "sid":"IDD2707TY390527",
            "sre":"OD001108A00151",
            "ktp":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
            "npwp":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
            "signature":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
            "formData":"data:file/txt;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
            "form":"data:file/pdf;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
        }

Normal Response :

        {
            "responseCode": "00",
            "responseDescription": "Doc accepted",
            "data": {
            "errorMessage": "RD-203"
            }
        }

Erorr Response :

        {
            "responseCode": "14",
            "responseDescription": "Registration ID tidak terdaftar",
            "data": {
            "errorMessage": "RD-007"
            }
        }

List of Error/Response Code

HTTP Status

Error Message

Response Code

Status

Response Description

Description

200

RD-203

00

Sukses

Doc accepted

Successful response is RC 00

200

RD-007

14

Gagal

Registration ID is not registered or documents are complete

Upload doc gagal

200

RD-999

99

Gagal

General error

Upload doc gagal

200

RD-099

99

Gagal

data cannot be null or blank

Upload doc gagal

D. Push Notification Approval

Endpoint Description

Service berikut digunakan untuk mengirimkan informasi pengajuan pembukaan Rekening Dana Nasabah (RDN) dari BRI ke Perusahaan Efek.

General Information

HTTP Method

POST

Path

Provide by PE

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Header Structure

Key

Value

Mandatory

Length

Description

Example

Content-Type

application/json

M

-

-

 

Request Structure

Field

Data Type

Mandatory

Length

Description

Example

registrationID

String

M

12

Unique ID for each submission

123456789012

sid

String

M

15

SID number from KSEI

IDD2707TY390527

sre

String

M

14

Securities sub account number from KSEI

123456789112342

partnerID

String

M

5

Unique code for each Securities Company

0D001

regStatus

String

M

4

Registration status code

0000

regDescription

String

O

-

Description of registration status code

RDN berhasil diproses

accountRDN

String

C

15

Customer fund account

067101000039317

accountName

String

C

20

RDN owner name

ABHIYASA SUTA BHUMIKAPALA

Response Structure

Field

Data Type

Mandatory

Length

Description

Example

responseCode

String

M

2

Response code

14

responseDescription

String

M

-

Response description

OTP requested succesfully

data

Object

M

-

JSON Object

-

registrationID

String

M

12

Unique ID for each submission

123456789012

partnerID

String

M

5

Unique code for each Securities Company

0D001

List of Registration Status

Error Code

Response Description

0001

Validasi investor sedang diproses

1001

SID dan SRE tidak valid

0002

Document Incomplete

0003

Pembukaan RDN sedang dilakukan

0004

Crosslink dalam proses

0000

RDN berhasil diproses

Request and Response Payload Sample

Request 1:

        {
            "registrationID":"123456789012",
            "sid":"IDD2707TY390527",
            "sre":"OD001108A00151",
            "partnerID":"0D001",
            "regStatus":"0002",
            "regDescription":"Document Incomplete",
            "accountRDN":"067101000039317",
            "accountName":"ABHIYASASUTABHUMIKAPALA"
        }

Request 2:

        {
            "registrationID":"123456789012",
            "sid":"IDD2707TY390527",
            "sre":"OD001108A00151",
            "partnerID":"0D001",
            "regStatus":"0000",
            "regDescription":"RDNberhasildiproses",
            "accountRDN":"067101000039317",
            "accountName":"ABHIYASASUTABHUMIKAPALA"
        }

Normal Response :

        {
            "responseCode":"00",
            "responseDescription":"RecordBerhasildiproses",
            "data":{
            "registrationID":"123456789012",
            "partnerID":"0D001"
            }
        }

Erorr Response :

        {
            "responseCode":"14",
            "responseDescription":"Registration ID tidak terdaftar",
            "data":{
            "registrationID":"123456789012",
            "partnerID":"0D001"
            }
        }

List of Error/Response Code

HTTP Status

Code

Status

Response Description

Description

200

00

Sukses

Record Successfully saved

Successful response is RC 00

200

14

Gagal

Registration ID not registered

Response gagal

200

99

Gagal

General error

Response gagal

E. Get Status Approval

Endpoint Description

Service berikut digunakan untuk mengetahui status pengajuan pembukaan Rekening Dana Nasabah (RDN) oleh Perusahaan Efek ke BRI

General Information

HTTP Method

POST

Path

/v2.0/rdn/GetStatusApproval

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Header Structure 

Key

Value

Mandatory

Length

Description

Example

Authorization

Bearer {token}

M

N/A

Access Token

 

BRI-Timestamp

 

M

-

ISO 8601 format. Timestamp must be in UTC or GMT +0 timezone.

2021-03-18T02:51:48.624Z

BRI-Signature

 

M

64

-

 

Content-Type

application/json

M

-

-

 

BRI-External-ID

Numeric

M

9

Unique

 

Request Structure

Field

Data Type

Mandatory

Length

Description

Example

registrationID

String

M

12

Unique ID for each submission

123456789012

sid

String

M

15

SID number from KSEI

020601000007317

sre

String

M

14

Securities sub-account number from KSEI

123456789112342

partnerID

String

M

5

Unique code for each Securities Company

0D001

Response Structure

Field

Data Type

Mandatory

Length

Description

Example

responseCode

String

M

2

Response code

14

responseDescription

String

M

-

Response description

Registration successfully

data

Object

M

-

JSON Object

-

errorMessage

String

M

6

Error Message

RD-203

regStatus

String

C

6

Registration status code

0001

regDescription

String

C

5

Registration status code description

Documents incomplete

accountRDN

String

C

15

Customer fund account

020601000007317

accountName

String

C

20

RDN owner name

ABHIYASA SUTA BHUMIKAPALA

List of Registration Status

Error Code

Response Description

0001

Investor validation is being processed

1001

SID and SRE are invalid

0002

Document Incomplete

0003

RDN opening is underway

0004

Crosslink in progress

0000

RDN successfully processed

Request and Response Payload Sample

Request :

        {
            "registrationID":"123456789012",
            "sid":"IDD2707TY390527",
            "sre":"OD001108A00151",
            "partnerID":"0D001"
        }

Normal Response :

        {
            "responseCode": "00",
            "responseDescription": "Pengajuan Ditemukan",
            "data": {
            "errorMessage": "RD-208",
            "regStatus": "0004",
            "regDescription": "Crosslink dalam proses",
            "accountName": null
            }
        }

Erorr Response :


 

List of Error/Response Code

HTTP Status

Error Message

Response Code

Status

Response Description

Description

200

RD-208

00

Sukses

Pengajuan ditemukan

RC 00 adalah Response Sukses

200

RD-004

04

Gagal

Pengajuan Tidak Ditemukan

Response Failed

200

RD-999

99

Gagal

General error

Response Failed
           

G. Get List Branch

Endpoint Description

Service berikut digunakan untuk meminta list cabang BRI dari Perusahaan Efek ke BRI sebelum dilakukan pengajuan pembukaan Rekening Dana Nasabah (RDN)

General Information

HTTP Method

POST

Path

/v2.0/rdn/GetListBranch

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Header Structure 

Key

Value

Mandatory

Length

Description

Example

Authorization

Bearer {token}

M

N/A

Access Token

 

BRI-Timestamp

 

M

-

ISO 8601 format. Timestamp must be in UTC or GMT +0 timezone.

2021-03-18T02:51:48.624Z

BRI-Signature

 

M

64

-

 

Content-Type

application/json

M

-

-

 

BRI-External-ID

Numeric

M

9

Unique

 

Request Structure

Field

Data Type

Mandatory

Length

Description

Example

partnerID

String

M

5

Unique code for each Securities Company

0D001

Response Structure

Field

Data Type

Mandatory

Length

Description

Example

responseCode

String

M

2

Response code

14

responseDescription

String

M

-

Response description

OTP requested succesfully

data

Object

M

-

JSON Object

-

errorMessage

String

M

6

Error Message

RD-203

partnerID

String

M

5

Unique code for each Securities Company

0D001

branchList

Array

C

 

List of branches in Array form

 

branchCode

String

C

15

BRI branch code

0206

branchName

String

C

20

RDN owner name

KCK

Request and Response Payload Sample

Request

        {
            "partnerID":"0D001"
        }

Normal Response :

        {
            "responseCode": "00",
            "responseDescription": "List Branch sukses didapatkan",
            "data": {
            "errorMessage": "RD-205",
            "partnerID": "0D001",
            "branchList": [
            {
            "branchCode": "0206",
            "branchName": "KCK"
            },
            {
            "branchCode": "0341",
            "branchName": "Pasar Minggu"
            }
            ]
            }
        }

Erorr Response :

        {
            "responsecode": "14",
            "responseDescription": "Partner ID tidak ditemukan",
            "data": {
            "errorMessage": "RD-014"
            }
        }

List of Error/Response Code

HTTP Status

Error Message

Response Code

Status

Response Description

Description

200

RD-205

00

Sukses

Branch List successfully obtained

Successful response only RC 00

200

RD-028

14

Gagal

Partner ID not found

Response Failed

200

RD-999

99

Gagal

General error

Response Failed