API Docs - Valas 2.0 - Nego Continue

API Information

Title Valas v2.0

Version

v1.2

URL Sandbox

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

URL Production

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

Version Control

Versi Doc Versi API Tanggal Link Dokumen Deskripsi

v1.0

v2.0

14 Oct 2022

Di sini Versi awal.

v1.1

v2.0

22 Dec 2022

Di sini

Menambahkan info mandatory dan length field pada struktur request seluruh endpoint
v1.2 v2.0 30 Mar 2023 Di sini Menambahkan RC 4038209 "Dormant Account" pada Endpoint Transaction Valas dan Transaction Valas Non Nego
v1.3 v2.0 19 May 2023 Di sini Menambahkan RC 4038215 "Transaction Not Permitted. Duplicate Jurnal Sequence" pada Endpoint Transaction Valas dan Transaction Valas Non Nego
v1.4 v2.0 07 Aug 2023 Di sini Mengubah mandatory "M" menjadi "O" pada field originalPartnerReferenceNo untuk endpoint Inquiry Transaction
v1.5 v2.0 03 Apr 2024 Halaman ini Menambahkan endpoint "Rate Profile", "Nego Rate Profile" dan "Nego Continue"

 

Deskripsi Produk

Penjelasan Produk

Dokumen ini bertujuan untuk menjelaskan spesifikasi API dari pengembangan Valas 2.0 dengan detail endpoint sebagai berikut :

  • Get Token
  • Valas Nego Info
  • Check Deal Code
  • Transaction Valas
  • Transaction Valas Non Nego
  • Inquiry Transaction
  • Inquiry Limit
  • Info Kurs Counter
  • Upload Underlying
  • Info Kurs Rate Profile
  • Nego Rate Profile
  • Nego Continue

Flow API

flow api valas v2.0

 

A. Get Token

Endpoint Description

Endpoint ini digunakan untuk menghasilkan token yang harus disertakan di setiap panggilan API. Letakkan token ini pada atribut Authorization yang ada di Header.

Method Environment URL
POST Sandbox https://sandbox.partner.api.bri.co.id/oauth/client_credential/accesstoken?grant_type=client_credentials
POST Production https://partner.api.bri.co.id/oauth/client_credential/accesstoken?grant_type=client_credentials

Header Data

Array Field

M/O

Format

Content-Type

M

application/x-www-form-urlencoded

Request Data

Array Field

Data Type

M/O

Information

client_id

string

M

Consumer key

client_secret

string

M

Consumer secret

Signature

Sebagai tambahan penjagaan keamanan dalam setiap API request, BRIAPI menggunakan signature untuk memastikan bahwa data di dalam setiap request dan response tidak bisa dibajak dan ditiru oleh pengguna yang tidak sah. Signature memastikan data yang dikirimkan adalah asli dan tidak bisa disanggah. Signature dihasilkan oleh pemakai layanan dan diverifikasi oleh penerima layanan. Signature dibentuk dari payload yang sudah ditentukan, dengan mengimplementasikan algoritma SHA256-HMAC dengan Consumer Secret sebagai kuncinya. Kemudian, akan dilakukan enkripsi dari signature ini dengan menggunakan Base64. Hasil akhirnya akan diletakkan di atribut BRI-Signature di Header.

Payload

Payload terdiri dari path, verb, token, timestamp, dan body.

Contoh:

path=/v1.0/bansos/binding &verb=POST&token=BearerR04XSUbnm1GXNmDiXx9ysWMpFWBr&timestamp=2019-01-02T13:14:15.678Z&body= 

 

Detail setiap elemen di dalam payload dijelaskan di bawah ini:

Path

Nilai untuk path adalah URL setelah hostname dan port tanpa query parameters.

Contoh:

from https://sandbox.partner.api.bri.co.id/v1.0/bansos/binding/ to /v1.0/bansos/binding

Verb

Method HTTP dengan huruf kapital.

Contoh: GET, POST, PUT, PATCH, and DELETE.

Token

Token yang dipakai di header Authorization.

Example:

Bearer R04XSUbnm1GXNmDiXx9ysWMpFWBr

Timestamp

Timestamp persis saat anda memanggil API. Format timestamp mengikuti format ISO8601 (yyyy-MM-ddTHH:mm:ss.SSSZ). Harus dalam zero UTC offset.

Contoh:

2019-01-02T13:14:15.678Z 

Body

Body Request untuk dipanggil di API.

Contoh:
&body={"hello":"world"}
If there is no request body, such as on GET call, leave it empty. Example:
&body=

 

B. Valas Nego Info

Endpoint Deskripsi

API Valas Nego Info digunakan untuk mendapatkan single info kurs nego tanpa dealcode.

General Information

HTTP Method POST
Path /v2.0/valas-info/kurs-nego
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Partner

rxEG1EMYHQZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

dealtCurrency

String

M

3

 

USD

counterCurrency String M 3   IDR

Struktur Request

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

M

7

Kode Respon

2008200

responseMessage

String

M

150

Detai Respon

Successful

data

Object

M

 

Detail isian object data terdapat pada tabel dibawah ini

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

currencyPair

String

M

 

 

USD-IDR

currency1

String

M

 

 

USD

currency2

String

M

 

 

IDR

buy

String

M

 

 

15669.0000

sell

String

M

 

 

15689.0000

lastestUpdate 

String

M

 

 

2022-11-30T16:31:24.26

Contoh Request & Response Payload Sample

Request :

{
   "dealtCurrency":"USD",
   "counterCurrency":"IDR"
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "currencyPair":"USD-IDR",
      "currency1":"USD",
      "currency2":"IDR",
      "buy":"15669.0000",
      "sell":"15689.0000",
      "lastestUpdate":"2022-11-30T16:31:24.26"
   }
}

Erorr Response :

{
   "responseCode":"4008201",
   "responseMessage":"Invalid Field Format dealtCurrency"
}

Daftar Error/Kode Respon

HTTP Status

Kode Respon

Status

Detai Respon

Deskripsi

200

2008200

Success

 Successful

Success

400

0601

Gagal

 Invalid Token

  • Token does not match
  • Token empty
  • Token Expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

Invalid Signature

  • Signature Salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)

  • value length melebihi batas (> 10000000)

  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field from Valas

  • Parameter Mandatory tidak camelCase

400

4008202

Gagal

Invalid Field Format {field name}

Request length, format tidak sesuai

401

4018200

Gagal

Unauthorized Client

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

400

4008222

Gagal

Bad Request
  • Content-Type bukan application/json

  • Data Json tidak sesuai struktur json (Service MS)

  • Error ketika insert DB

403

4038215

Gagal

Transaction Not Found
  • Currency List Tidak Terdaftar di db
  • Response Message “No Data” Backend (ESB)

403

4038215

Gagal

Transaction Not Permitted.Currency Pair Not Found

Currency List tidak terdaftar disisi backend (ESB)

504

5048200

Gagal

Timeout Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping

Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

C. Check Deal Code

Endpoint Description

API Check Deal Code digunakan untuk inquiry dealcode ke briefx.

General Information

HTTP Method POST
Path /v2.0/valas-transaction/nego/dealcode
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Partner

rxEG1EMYHQZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

dealCode

String

M

 

 

O0003540

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

M

7

Kode Respon

2008200

responseMessage

String

M

150

Detail Respon

Successful

data

Object

M

 

Detail isian object data terdapat pada tabel dibawah ini

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

dealNumber

String

M

 

 

O0761674

dealDate

String

M

 

 

2022-12-05T10:29:07.067

valueDate

String

M

 

 

2022-12-05T00:00:00

debitCurrency

String

M

 

 

USD

creditCurrency

String

M

 

 

EUR

debitAmount 

Numerric

M

 

 

12.27

creditAmount

Numerric

M

 

 

10.00

dealRate 

Numerric

M

 

 

1.2273

buyRate 

Numerric

M

 

 

13819.8280

sellRate 

Numerric

M

 

 

16961.0750

timeExpired  

String

M

 

 

2022-12-05T23:45:00

Contoh Request & Response Payload Sample

Request :

{
   "dealCode":"O0003540"
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "dealNumber":"O0761674",
      "dealDate":"2022-12-05T10:29:07.067",
      "valueDate":"2022-12-05T00:00:00",
      "debitCurrency":"USD",
      "creditCurrency":"EUR",
      "debitAmount":"12.27",
      "creditAmount":"10.00",
      "dealRate":"1.2273",
      "buyRate":"13819.8280",
      "sellRate":"16961.0750",
      "timeExpired":"2022-12-05T23:45:00"
   }
}

Erorr Response :

{
   "responseCode":"4008222",
   "responseMessage":"Dealcode Expired"
}

Daftar Error/Kode Respon

HTTP Status

Kode Respon

Status

Detail Respon

Deskripsi

200

2008200

Success

 Successful

Success

400

0601

Gagal

 Invalid Token

  • Token does not match
  • Token empty
  • Token Expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

 Invalid Signature

  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

 Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)

  • value length melebihi batas (> 10000000)

  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas

  • Parameter Mandatory tidak camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format tidak sesuai

400

4008200

Gagal

 Bad Request

  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)

401

4018200

Gagal

 Unauthorized Client

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

400

4008222

Gagal

Dealcode Expired
  • Response Parameter “status” Backend memiliki status value “DE”

  • Time Expired melebihi set waktu dealCode yang ditentukan

403

4038215

Gagal

Transaction Not Permitted.dealcode already used

Response Parameter “status” Backend memiliki value "SLU", "SK", "STOK", "GK" atau selain status “IN” dan status yang telah disebutkan

403

4038215

Gagal

Transaction Not Permitted.value date does not match today’s date

Transaksi pada dealCode tidak untuk hari yang di set

403

4038215

Gagal

Transaction Not Permitted. Inquiry Delcode Failed.

dealCode tidak ada

504

5048200

Gagal

Timeout Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping

Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

D. Transaction Valas

Endpoint Description

API Transaction Valas digunakan untuk melakukan transaksi valas berdasarkan rate yang ada saat itu.

General Information

HTTP Method POST
Path /v2.0/valas-transaction/nego
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Length Description Example

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Partner

rxEG1EMYHQZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

debitAccount

String

M

15

 

030702000141509
creditAccount String M 15   034401083104504
dealCode String     O0003540
remark String   15   374628374
partnerReferenceNo String M 64   6278163827789
underlyingReference String C      

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

M

7

Kode Respon

2008200

responseMessage

String

M

150

Detail Respon

Successful

data

Object

M

 

Detail isian object data terdapat pada tabel dibawah ini

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

referenceNo

String

 

 

 

8757771
partnerReferenceNo

String

 

 

 

6278163827789
dealCode

String

 

 

 

O0003540

buy

String

 

 

 

14000.00

sell

String

 

 

 

1.00
debitAmount

String

 

 

 

11.00

creditAmount

String

 

 

 

154000.00

remark String       374628374

Contoh Request & Response Payload Sample

Request :

{
 "debitAccount": "030702000141509",
 "creditAccount": "034401083104504",
 "dealCode": "O0003540",
 "remark": "374628374",
 "partnerReferenceNo": "6278163827789",
 "underlyingReference": ""/CONDITIONAL
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "referenceNo":"8759384",
      "partnerReferenceNo":"6278163827813",
      "dealCode":"O0003540",
      "buy":"14000.00",
      "sell":"1.00",
      "debitAmount":"11.00",
      "creditAmount":"154000.00",
      "remark":"374628374"
   }
}

Erorr Response :

{
   "responseCode":"4038215",
   "responseMessage":"Transaction Not Permitted. Inquiry Failed"
}

Daftar Error/Kode Respon

HTTP Status

Kode Respon

Status

Detail Respon

Deskripsi

200

2008200

Success

 Successful

Success

400

0601

Gagal

 Invalid Token

  • Token tidak sesuai
  • Token kosong
  • Token expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

 Invalid Signature

  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

 Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)

  • value length melebihi batas (> 10000000)

  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas

  • Parameter tidak camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format tidak sesuai

400

4008200

Gagal

 Bad Request

  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)

400

4018200

Gagal

 Unauthorized Client

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

400

4008222

Gagal

Dealcode Expired

  • Response Parameter “status” Backend memiliki value “DE”

  • Time Expired melebihi setn waktu dealCode yang ditentukan

403

4038209

Gagal

Dormant Account Akun tidak aktif

403

4038215

Gagal

Transaction Not Permitted.dealcode already used

Response Parameter “status” Backend memiliki value "SLU", "SK", "STOK", "GK" atau selain status “IN” dan status yang telah disebutkan

403

4038215

Gagal

Transaction Not Permitted.value date does not match today’s date

Transaksi pada dealCode tidak untuk hari yang di set

403

4038215

Gagal

Transaction Not Permitted. Inquiry Delcode Failed.

dealCode Tidak ada

403

4038215

Gagal

Transaction Not Permitted. Inquiry Delcode Failed.

Jurnal Sequence Duplikat

403

4038218

Gagal

Inactive Account

debitAccount atau creditAccount sudah tidak aktif atau Rekening Tidak Bisa Ditarik

403

4038206

Gagal

Feature Not Allowed At This Time. Must Upload Underlying

Transaksi melebihi limit, harus melakukan upload underlying

404

4048211

Gagal

Invalid Account

debitAccount / creditAccount yang dimasukkan tidak valid

404

4048245

Gagal

debitAccount Not Found

debitAccount tidak ditemukan

400

4008224

Gagal

Transaction Over Limit

Melebihi limit untuk melakukan transaksi

404

4048241

Gagal

Invalid underlyingReference

Missing input underlyingReference

404

4048242

Gagal

Expired underlyingReference

underlyingReference sudah melewati masa aktif (1 hari)

404

4048243

Gagal

underlyingReference already in uses

underlyingReference sudah digunakan

403

4038214

Gagal

Insufficient Funds

Saldo tidak cukup

403

4038215

Gagal

Transaction Not Permitted. Currency discrepency

debitAccount/creditAccount yang direquest tidak sesuai mata uang yang di input

403

4038215

Gagal

Transaction Not Permitted.Transaction is not supported

Transaksi tidak bisa diteruskan

400

4008213

Gagal

Invalid BRI External ID

Duplicate BRI EXTERNAL ID di header

409

4098201

Gagal

Duplicate partnerReferenceNo

partnerReferenceNo sudah digunakan (harus unik)

504

5048200

Gagal

Timeout Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping

Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

E. Transaction Valas Non Nego

Endpoint Description

API Transaction Valas Non Nego digunakan untuk melakukan transaksi valas berdasarkan rate yang ada saat itu

General Information

HTTP Method POST
Path /v2.0/valas-transaction/counter
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Partner

rxEG1EMYHQZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Example

debitAccount

String

M

15

 

030702000141509

creditAccount

String

M

15

 

034401083104504

debitCurrency

String

M

3

 

USD

creditCurrency

String

M

3

 

IDR

debitAmount

String

M

 

 

3.00

remark

String

 

15

 

374628374

partnerReferenceNo

String

M

64

 

6278163827120

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

 

7

Kode Respon

2008200

responseMessage

String

 

150

Detail Respon

Successful

data

Object

 

 

Detail isian object data terdapat pada tabel dibawah ini

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

referenceNo

String

 

 

 

8759248

partnerReferenceNo

String

 

 

 

6278163827789

buy

String

 

 

 

13955.00

sell

String

 

 

 

1.00

DebitAmount

String

 

 

 

3.00

CreditAmount

String

 

 

 

41865.00

remark

String

 

 

 

374628374

Contoh Request & Response Payload Sample

Request :

{
   "debitAccount":"030702000141509",
   "creditAccount":"034401083104504",
   "debitCurrency":"USD",
   "creditCurrency":"IDR",
   "debitAmount":"3.00",
   "remark":"374628374",
   "partnerReferenceNo":"6278163827120"
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "referenceNo":"8759248",
      "partnerReferenceNo":"6278163827120",
      "buy":"13955.00",
      "sell":"1.00",
      "DebitAmount":"3.00",
      "CreditAmount":"41865.00",
      "remark":"374628374"
   }
}

Erorr Response :

{
   "responseCode":"4098201",
   "responseMessage":"Duplicate partnerReferenceNo"
}

List of Error/Response Code

HTTP Status

Response Code

Status

Detail Respon

Description

200

2008200

 Success

 Successful

 Success

400

0601

Gagal

 Invalid Token

  • Token tidak sesuai
  • Token kosong
  • Token Expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

 Invalid Signature

  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

 Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)
  • value length melebihi batas (> 10000000)
  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas
  • Parameter tidak camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format tidak sesuai

400

4008200

Gagal

 Bad Request

  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)

401

4018200

Gagal

 Unauthorized Client

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

404

4048245

Gagal

debitAccount Not Found debitAccount tidak ditemukan

400

4008224

Gagal

Transaction Over Limit Transaksi tidak bisa diteruskan

403

4038209

Gagal

Dormat Account Akun tidak aktif

403

4038214

Gagal

Insufficient Funds Saldo tidak cukup

403

4038215

Gagal

Transaction Not Permitted.Currency discrepency debitAccount/creditAccount yang direquest tidak sesuai mata uang yang di input

403

4038215

Gagal

Transaction Not Permitted.Transaction is not supported Transaksi tidak bisa diteruskan

400

4008213

Gagal

Invalid BRI External ID Duplicate BRI EXTERNAL ID di header

403

4038215

Gagal

Transaction Not Permitted.Unused Parameter Terdapat Field creditAmount di body Request

403

4038215

Gagal

Transaction Not Permitted. Duplicate Jurnal Sequence Jurnal Sequence Duplikat

404

4048213

Gagal

Invalid Amount Input debitAmount “0” atau kurang dari 1

404

4048211

Gagal

Invalid Account debitAccount / creditAccount yang dimasukkan tidak valid

403

4038218

Gagal

Inactive Account debitAccount atau creditAccount sudah tidak aktif

409

4098201

Gagal

Duplicate partnerReferenceNo partnerReferenceNo sudah digunakan (harus unik)
504 5048200 Gagal Timeout Response time melebihi batas timeout di apigee (55s) dan service
500 5008200 Gagal General Error
  • General Error Backend
  • unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

F. Inquiry Transaction

Endpoint Description

API Inquiry Transaction digunakan untuk melakukan inquiry dari transaksi valas yang sudah dilakukan.

General Information

HTTP Method POST
Path /v2.0/valas-transaction/inquiry
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Partner

rxEG1EMYHQ ZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Example

originalPartnerReferenceNo

String

O

64

 

6278163827789

originalReferenceNo

String

M

64

 

8757771

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

 

7

Kode Respon

2008200

responseMessage

String

 

150

Detail Respon

Successful

data

Object

 

 

Detail isian object data terdapat pada tabel dibawah ini

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

originalPartnerReferenceNo

String

 

 

 

62791638699848

originalReferenceNo

String

 

 

 

7540140

dealCode

String

 

 

 

AP60136176

buy

String

 

 

 

10698.2569

sell

String

 

 

 

126.9504

amount

String

 

 

 

100979.86

remark

String

 

 

 

3746283742343454555445567788776 5544345671234512345123451234561 23

originalTransactionStatusCode

String

 

 

 

00

originalTransactionStatus

String

 

 

 

Transaction approved

debitAmount

String

 

 

 

100979.86

creditAmount

String

 

 

 

84344627.11

Contoh Request & Response Payload Sample

Request :

{
   "originalPartnerReferenceNo":"6278163827789",
   "originalReferenceNo":"8757771"
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "originalPartnerReferenceNo":"62791638699848",
      "originalReferenceNo":"7540140",
      "dealCode":"AP60136176",
      "buy":"10698.2569",
      "sell":"126.9504",
      "debitAmount":"100979.86",
      "creditAmount":"84344627.11",
      "remark":"3746283742343454555445567788776554434567123451234512345123456123",
      "originalTransactionStatusCode":"00",
      "originalTransactionStatus":"Transaction approved"
   }
}

Erorr Response :

{
   "responseCode":"4048201",
   "responseMessage":"Transaction Not Found"
}

List of Error/Response Code

HTTP Status

Response Code

Status

Detail Respon

Deskripsi

200

2008200

 Success

 Successful

 Success

400

0601

Gagal

 Invalid Token

  • Token tidak sesuai
  • Token kosong
  • Token expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

 Invalid Signature

  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

 Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)
  • value length melebihi batas (> 10000000)
  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas
  • Parameter tidak camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format tidak sesuai

400

4008200

Gagal

 Bad Request

  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)

401

4018200

Gagal

 Unauthorized Client

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

404

4048201

Gagal

Transaction Not Found

d originalPartnerReferenceNo & originalRefrenceNo tidak ada

504

5048200

Gagal

Timeout Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • Unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

G. Inquiry Limit

Deskripsi Endpoint

API Inquiry Limit digunakan untuk check limit harian nasabah.

General Information

HTTP Method POST
Path /v2.0/valas-transaction/inquiry-limit
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Partner

rxEG1EMYHQ ZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

debitAccount

String

M

15

 

020602000008513

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

 

7

Kode Respon

2008200

responseMessage

String

 

150

Detail Respon

Successful

data

object

 

 

Detail isian object data terdapat pada tabel dibawah ini

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

totalTransaction

String

 

 

 

0

underlyingThreshold

String

 

 

 

25000

underlyingFormulas

String

 

 

 

PER_BULAN

Request & Response Payload Sample

Request :

{ 
   "debitAccount": "020602000008513" 
}

Normal Response :

{ 
     "responseCode": "2008200", 
     "responseMessage": "Successful", 
     "data": { 
        "totalTransaction": 0, 
        "underlyingThreshold": "25000", 
        "underlyingFormulas": "PER_BULAN"
  } 
}

Erorr Response :

{ 
    "responseCode": "4008202", 
    "responseMessage": "Invalid Mandatory Field debitAccount" 
}

List of Error/Response Code

HTTP Status

Response Code

Status

Detail Respon

Deskripsi

200

2008200

Success

 Successful

Success

400

0601

Gagal

 Invalid Token

  • Token tidak sesuai
  • Token kosong
  • Token expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

 Invalid Signature

  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

 Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)
  • value length melebihi batas (> 10000000)
  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas
  • Parameter tidak camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format tidak sesuai

400

4008200

Gagal

 Bad Request

  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)

401

4018200

Gagal

 Unauthorized Client

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

404

4048245

Gagal

debitAccount Not Found debitAccount tidak ditemukan

504

5048200

Gagal

Timeout Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • Unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

H. Info Kurs Counter

Deskripsi Endpoint

API Info Kurs Counter digunakan untuk mendapatkan single info kurs counter

General Informasi

HTTP Method POST
Path /v2.0/valas-info/kurs-counter
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key

value

Mandatory

Panjang

Deskripsi

Contoh

Content-Type

application/json

M

 -

 

 

Authorization

Bearer {token}

M

 -

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

 64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

 -

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

 -

Kode Partner

rxEG1EMYHQ ZMgb3

Request Structure

Key

Data Type

Mandatory

Panjang

Deskripsi

Contoh

dealtCurrency

string

M

3

 

USD

counterCurrency

string

M

3

 

IDR

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

string

7

 

Kode Respon

2008200

responseMessage

string

150

 

Detail Respon

Successful

data

Object

 

 

Detail isian object data terdapat pada tabel dibawah ini

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Contoh

Example

currency

String

 

 

 

USD

counterBuy

String

 

 

 

13955.0000

counterSell

String

 

 

 

14105.0000

LastestUpdate

String

 

 

 

2022-12-02T13:28:22.1

Contoh Request & Response Payload Sample

Request :

{
   "dealtCurrency":"USD",
   "counterCurrency":"IDR"
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "currency":"USD",
      "counterBuy":"13955.0000",
      "counterSell":"14105.0000",
      "LastestUpdate":"2022-12-02T13:28:22.1"
   }
}

Error Response :

{
   "responseCode":"4048201",
   "responseMessage":"Transaction Not Found"
}

Daftar Error/Kode Respon

HTTP Status

Kode Respon

Status

Detai Respon

Deskripsi

200

2008200

Success

 Successful

Success

400

0601

Gagal

 Invalid Token

  • Token tidak sesuai
  • Token kosong
  • Token expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

 Invalid Signature

  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

 Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)
  • value length melebihi batas (> 10000000)
  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas
  • Parameter tidak camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format tidak sesuai

401

4018200

Gagal

 Unauthorized Client

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

400

4008200

Gagal

Bad Request
  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)
  • Error ketika insert DB

404

4048201

Gagal

Transaction Not Found
  • Currency List Tidak Terdaftar di db
  • Response Message “No Data” Backend (BRIGATE)

403

4038215

Gagal

Transaction Not Permitted.Currency Pair Not Found Currecy List tidak terdaftar di Backend

504

5048200

Gagal

Timeout Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • unexpected error
  • Service is off or not available
  • List of errors that are not remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

I. Upload

Deskripsi Endpoint

API Upload digunakan untuk upload underlying.

General Information

HTTP Method POST
Path /v2.0/valas-transaction/upload-underlying
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Respon

rxEG1EMYHQ ZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

fileData

base64

M

 

File dengan maksimal size 5MB

{inputan base64}}

fileName

String

M

 

Nama File

fileNameTest

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

 

7

Kode Respon

2008200

responseMessage

String

 

150

Detail Respon

Successful

data

object

 

 

Detail isian object data terdapat pada tabel dibawah ini

 

Response Structure in object"data"

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

underlyingReference

String

 

 

 

1669089033515629956

Contoh Request & Response Payload Sample

Request :

curl --location --request POST 'https://sandbox.partner.api.bri.co.id/v2.0/valas/upload-underlying' \ 
--header 'BRI-Signature: {{signature}}' \ 
--header 'BRI-Timestamp: {{timestamp}}' \ 
--header 'Content-Type: application/json' \ 
--header 'partnerCode: rxEG1EMYHQZMgb3' \ 
--data-raw '{ 
    "fileData": "{Inputan Base64}", 
    "fileName": "fileNameTest" 
}'

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "underlyingReference":"1669089033515629956"
   }
}

Erorr Response :

{
   "responseCode":"4008201",
   "responseMessage":"Invalid Field Format fileName"
}

List of Error/Response Code

HTTP Status

Kode Respon

Status

Detail Respon

Deskripsi

200

2008200

 Success

 Successful

 Success

400

0601

Gagal

 Invalid Token

  • Token does not match
  • Token empty
  • Token expired
  • Product has not been registered with devapps

400

0602

Gagal

 Invalid Signature

  • Wrong signature
  • Invalid timestamp or timestamp difference
  • Incorrect payload for generating a signature

400

0109

Gagal

 Invalid request parameter

  • Errors related to regex (SQL injection, etc.)
  • The length of the value exceeds the limit (> 10000000).
  • Array element count exceeded the limit (> 100).

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request the missing mandatory field from Valas
  • Mandatory parameters are not camelCase.

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format does not match

400

4008200

Gagal

 Bad Request

  • Content-Type is not application/json
  • Json data doesn't fit json structure (Service MS)

401

4018200

Gagal

 Unauthorized Client

  • Request missing partnerCode does not match
  • partnerCode is not registered
  • The requested partnerCode does not match the partnerCode in the devapps apigee

403

4038215

Gagal

Transaction Not Permitted.Files too big

Uploaded files exceed 10 MB

403

4038215

Gagal

Transaction Not Permitted. Duplicate filename.

Already Existing File Name

413

-

Gagal

Request Entity Too Large

Uploaded files exceed 5 MB

504

5048200

Gagal

Timeout Response time exceeds the timeout limit in apigee (55s) and service

500

5008200

Gagal

General Error
  • General Error Backend
  • Unexpected error
  • Service is off or not available.
  • List of errors that are not remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

J. Info Kurs Rate Profile

Deskripsi Endpoint

API Info Kurs Rate Profile digunakan untuk mendapatkan info dari kurs Rate Profile

General Information

HTTP Method POST
Path /v2.0/valas-info/rate-profile
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Respon

rxEG1EMYHQ ZMgb3

Request Structure

Field

Tipe Data

Mandatory

Panjang

Deskripsi

Contoh

accountNo

String

M

16

 

0206xxxxxxxxxxxx

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

 

7

Kode Respon

2008200

responseMessage

String

 

150

Detail  Respon

Successful

data

Array Object

 

 

Detail isian object data terdapat pada tabel dibawah ini

 

Response Structure in object"data"

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

bid

String

 

 

 

14835

ask String       15055
currencyPair String       USD-IDR

Contoh Request & Response Payload Sample

Request :

{
    "accountNo": "0206xxxxxxxxxxxx",
}

Normal Response :

{
    "responseCode": "2008200",
    "responseMessage": "Successful",
    "data": [
        {
            "bid": "14835",
            "ask": "15055",
            "currencyPair": "USD-IDR"
        },
        {
            "bid": "16387.656",
            "ask": "16445.5",
            "currencyPair": "EUR-IDR"
        }
    ]
}

Erorr Response :

{
    "responseCode": "4048201",
    "responseMessage": "Transaction Not Found"
}

Daftar Error/Kode Respon

HTTP Status

Kode Respon

Status

Detail Respon

Deskripsi

200

2008200

Success

Successful Success

400

0601

Gagal

Invalid Token
  • Token tidak sesuai
  • Token kosong
  • Token expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

Invalid Signature
  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

Invalid request parameter
  • Error yang berkaitan dengan regex(SQL injection, etc)
  • value length melebihi batas (> 10000000)
  • Array element count melebihi batas (>100)

400

4008202

Gagal

Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas
  • Parameter tidak camelCase

400

4008201

Gagal

Invalid Field Format {field name}

Request length, format tidak sesuai

401

4018200

Gagal

Unauthorized Client
  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

400

4008200

Gagal

Bad Request
  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)
  • Error ketika insert DB

504

5048200

Gagal

Timeout

Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • Unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

K. Nego Rate Profile

Deskripsi Endpoint

API Transaksi Nego Rate Profile digunakan untuk melakukan transaksi valas dengan kurs rate profile atau nego nilai kurs

General Information

HTTP Method POST
Path /v2.0/valas-transaction/nego-rate-profile
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp the time you called the API. The time format used refers to the ISO 8601 format (yyyy-MMddTHH:mm:ss.SSSZ). The time must be in UTC zero.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Partner code

rxEG1EMYHQ ZMgb3

Request Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

partnerReferenceNo

String

M

64

 

 

debitAccount

String

M

16

 

0206xxxxxxxxxxxx
creditAccount          
debitCurrency          
creditCurrency          
debitAmount          
remark          
debitRate          
underlyingReference          

Response Structure

Field

Data Type

Mandatory

Panjang

Deskripsi

Contoh

responseCode

String

M

7

Response code

2008200

responseMessage

String

M

150

Response message

Successful

data

object

 

 

 

 

Structure within "data" Object

Field

Data Type

Mandatory

Length

Description

Example

referenceNo

String

M

 

 

8759384
partnerReferenceNo String M     6278163827813
buy String M     USD-IDR
sell String M     14000.00
debitAmount String M     1.00
creditAmount String M     154000.00
remark String M     374628374

Request & Response Payload Sample

Request :

{
   "partnerReferenceNo":"6278163827120",
   "debitAccount":"030702000141509",
   "creditAccount":"034401083104504",
   "debitCurrency":"EUR",
   "creditCurrency":"USD",
   "debitAmount":"10000.00",
   "remark":"test",
   "debitRate":"1.0825",
   "underlyingReference":"1029384756"
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "data":{
      "referenceNo":"8759384",
      "partnerReferenceNo":"6278163827813",
      "buy":"14000.00",
      "sell":"1.00",
      "debitAmount":"11.00",
      "creditAmount":"154000.00",
      "remark":"374628374"
   }
}

Erorr Response :

{
   "responseCode":"4048201",
   "responseMessage":"Transaction Not Found"
}

Daftar Error/Kode Respon

HTTP Status

Response Code

Status

Response Message

Description

200

2008200

 Success

 Successful

 Success

400

0601

Gagal

 Invalid Token

  • Token tidak sesuai
  • Token kosong
  • Token expired
  • Product belum di daftarkan ke devapps

400

0602

Gagal

 Invalid Signature

  • Signature salah
  • Perbedaan timestamp atau timestamp tidak valid
  • Payload untuk generate signature salah

400

0109

Gagal

 Invalid request parameter

  • Error yang berkaitan dengan regex(SQL injection, etc)
  • value length melebihi batas (> 10000000)
  • Array element count melebihi batas (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field dari Valas
  • Parameter tidak camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Request length, format tidak sesuai

400

4008200

Gagal

 Bad Request

  • Request missing partnerCode tidak sesuai
  • partnerCode tidak terdaftar
  • partnerCode yang direquest tidak sesuai dengan partnerCode yang di devapps apigee

401

4018200

Gagal

 Unauthorized Client

  • Content-Type bukan application/json
  • Data Json tidak sesuai struktur json (Service MS)
  • Error ketika insert DB

504

5048200

Gagal

Timeout Response time melebihi batas timeout di apigee (55s) dan service

500

5008200

Gagal

General Error
  • General Error Backend
  • Unexpected error
  • Service mati/tidak tersedia
  • List-list error yang tidak ke remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

L. Nego Continue

Deskripsi Endpoint

API Transaksi Nego Continue digunakan untuk melanjutkan nego kurs valas yang diajukan oleh partner/merchant.

General Information

HTTP Method POST
Path /v2.0/valas-transaction/continue
Type Format JSON
Authentication OAuth 2.0

Header Structure

Key Value Mandatory Panjang Deskripsi Contoh

Content-Type

application/json

M

-

 

 

Authorization

Bearer {token}

M

-

Token OAuth 2.0

https://developers.bri.co.id/id/docs/authentication

 

BRI-Signature

 

M

64

Signature

https://developers.bri.co.id/id/docs/authentication

 

BRI-Timestamp

 

M

-

Timestamp

Timestamp Waktu dimana anda memanggil API. Format waktu yang digunakan mengacu ke format ISO8601 (yyyy-MMddTHH:mm:ss.SSSZ). Waktu tersebut harus dalam UTC nol.

2020-01- 15T17:01: 11+07:00

partnerCode

 

M

-

Kode Respon

rxEG1EMYHQ ZMgb3

Request Structure

Field

Data Type

Mandatory

Length

Description

Example

debitAccount

String

M

16

 

0206xxxxxxxxxxxx

creditAccount

String

M

16

 

 

debitCurrency String M 3    
creditCurrency String M 3    
debitAmount String M      
debitRate String M      

Response Structure

Field

Data Type

Mandatory

Panjang

Deskrispsi

Contoh

responseCode

String

 

7

Kode Respon

2008200

responseMessage

String

 

150

Detail Respon

Successful

additionalInfo

object

 

 

 

 

Structure within "data" Object

Field

Data Type

Mandatory

Panjang

Deksripsi

Contoh

dealCode

String

 

 

 

N35227921

Request & Response Payload Sample

Request :

{
   "partnerReferenceNo":"6278163827120",
   "debitAccount":"030702000141509",
   "creditAccount":"034401083104504",
   "debitCurrency":"EUR",
   "creditCurrency":"USD",
   "debitAmount":"10000.00",
   "debitRate":"1.0825"
}

Normal Response :

{
   "responseCode":"2008200",
   "responseMessage":"Successful",
   "additionalInfo":{
      "dealCode":"N35227921"
   }
} 
}

Erorr Response :

{
   "responseCode":"4048201",
   "responseMessage":"Transaction Not Found"
}

Daftar Error/Kode Respon

HTTP Status

Kode Respon

Status

Detail Respon

Deskripsi

200

2008200

 Success

 Successful

 Success

400

0601

Gagal

 Invalid Token

  • Token tidak sesuai
  • Token empty
  • Token expired
  • The product has not been registered with devapps

400

0602

Gagal

 Invalid Signature

  • Incorrect Signature
  • Timestamp mismatch
  • Payload for generating signature is incorrect

400

0109

Gagal

 Invalid request parameter

  • Errors related to regex (SQL injection, etc)
  • Value length exceeds limit (> 10000000)
  • Array element count exceeds limit (>100)

400

4008201

Gagal

 Invalid Mandatory Field {field name}

  • Request missing mandatory field from Valas
  • Mandatory parameters are not camelCase

400

4008202

Gagal

 Invalid Field Format {field name}

Incorrect field format or length

400

4008200

Gagal

 Bad Request

  • Missing or incorrect partnerCode
  • Unregistered partnerCode
  • Mismatched partnerCode

401

4018200

Gagal

 Unauthorized Client

  • Non-JSON Content-Type
  • Incorrect JSON structure (Service MS)
  • Error when inserting DB

504

5048200

Gagal

Timeout Response time exceeds the timeout limit in apigee (55s) and service

500

5008200

Gagal

General Error
  • General Error Backend
  • Unexpected error
  • Service is off or not available.
  • List of errors that are not remapping
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan