Intrabank Transfer

Buat API

Permudah Bisnis Anda dengan BRIAPI

Tonton videonya dan lihat bagaimana BRIAPI dapat membuat bisnis Anda menjadi lebih efisien dengan Transfer Intrabank BRI.

Buat API Sekarang

 

API Information

Title

API Account Inquiry/Intrabank Transfer

Version

v2.0

URL Sandbox

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

URL Production

  

Version Control

API Version

Date

Document Link

Description
v1.0

7 December 2021

Here

Baseline version
v2.0 29 Jan 2024 This Pages
  • Penyesuaian isi Response Sample di endpoint Internal Account Inquiry
  • Penyesuaian field value dalam Request Structure di endpoint Transfer Intrabank
  • Penyesuaian isi Request dan Response Sample di endpoint Transfer Intrabank
v3.0 20 Feb 2025 This Pages
  • Penyesuaian object originatorInfos Request dan Response Transfer Intrabank

 

Product Description

Gambaran produk

Fitur ini digunakan untuk pemindahbukuan dana yang bersumber dari PJP PIAS melalui layanan transfer kredit di Bank PJP AIS menggunakan API transfer intrabank

Header

Key

Value

Format

Mandatory

Length

Description

Authorization

Authorization

String

M

 

Bearer {Token}

X-TIMESTAMP

timestamp

Datetime

M

 

Format Timestamp ISO8601

X-SIGNATURE

signature

String

M

 

HMAC_SHA512

Content-type

application/json

 

M

 

application/json

X-PARTNER-ID

 

Alphanumeric

M

36

 

CHANNEL-ID

 

Alphanumeric

M

5

 

X-EXTERNAL-ID

 

Numeric

M

36

 

Endpoint

A. Internal Account Inquiry

endpoint ini digunakan untuk memvalidasi nomor dan nama rekening tujuan sebelum melakukan pemindahbukuan intrabank

General Information

HTTP Method

POST

Path

/intrabank/snap/v2.0/account-inquiry-internal

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Request Structure

Field

Data Type

Format

Mandatory

Length

Description

Example

beneficiaryAccountNo

String

Numeric

M

15

Note :

SNAP BI

Length

(34)

Nomor akun penerima

888801000157508

additionalInfo

Object

 

O

 

 

 

>deviceId

String

Alphanumeric

O

 

 

 

>channel

String

Alphanumeric

O

 

 

 

Response Structure & Sample

Field

Data Type

Format

Mandatory

Length

Description

Example

responseCode

 

String

Numeric

M

7

Response code

2001500

responseMessage

String

Alphanumeric

M

150

Response description

Successful

referenceNo

String

Numeric

O

Note :

SNAP BI

(C)

7

Note :

SNAP BI

Length

(64)

Identifikasi transaksi pada sistem penyedia layanan. harus dilengkapi setelah transaksi berhasil

2021112

beneficiaryAccountName

String

Alphanumeric

M

100

Nama rekening penerima

John Doe

beneficiaryAccountNo

String

Numeric

M

15

Note :

SNAP BI

Length

(34)

Nomor rekening penerima

888801000157508

beneficiaryAccountStatus

String 

Alphanumeric

O

50

Status rekening tujuan transaksi, meliputi :

  • Rekening Aktif
  • Rekening tidak bisa melakukan transaks

Active

beneficiaryAccountType

String

Alphanumeric

O

1

Jenis rekening penerima

"D" untuk rekening giro

"S" untuk rekening tabungan

S

currency

String

Alphanumeric

O

3

Mata uang

IDR

additionalInfo

Object

 

O

 

 

 

>channel

String

Alphanumeric

O

 

 

mobilephone

>deviceId

String

Alphanumeric

O

 

 

123456792 37

Request & Response Payload Sample

Request :

{
 "beneficiaryAccountNo": "888801000157508",
 "additionalInfo": {
 "deviceId": "12345679237",
 "channel": "mobilephone"
 }
}

Normal Response :

{
  "responseCode": "2001500",
  "responseMessage": "Successful",
  "referenceNo": "",
  "beneficiaryAccountNo": "888801000157508",
  "beneficiaryAccountName": "Dummy",
  "beneficiaryAccountStatus": "Rekening Aktif",
  "beneficiaryAccountType": "S",
  "currency": "IDR",
  "additionalInfo": {
    "channel": "mobilephone",
    "deviceId": "12345679237"
  }
}

Error Response :

{
 "responseCode": "4001502",
 "responseMessage": "Invalid Mandatory Field beneficiaryAccountNo"
}

List of Error/Response Code

HTTP Status

Service Code

Code

Status

Response Description

Deskripsi

200

15

00

Success

Successful

 

400

15

01

Failed

Invalid Field Format {fieldName}

 

400

15

02

Failed

Invalid Mandatory Field {fieldName}

 

401

15

00

Failed

Unauthorized. Client

 

404

15

11

Failed

Invalid Card/Account/Customer[info]/Virtual Account

 

500

15

00

Pending

General Error

 
504 15 00 Pending Timeout  
Setiap respons kesalahan yang tidak tercantum dalam daftar respons BRIAPI dianggap pending dan memerlukan penyelidikan lebih lanjut.

B. Transfer Intrabank

Endpoint ini digunakan untuk melakukan pemindahbukuan dana dari rekening Non-PJP Pengguna Layanan, PJP PIAS, atau PJP AIS Lembaga Selain Bank ke rekening tujuan pada satu PJP AIS Bank.

General Information

HTTP Method

POST

Path

/intrabank/snap/v2.0/transfer-intrabank

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Request Structure

Field

Data Type

Format

Mandatory

Length

Description

Example

partnerReferenceNo

String

Alphanumeric

M

20

Note:

SNAP BI

Length

(64)

Identifikasi transaksi pada sistem layanan konsumen

2020102900000000000001

amount

Object

 

M

 

 

 

>value

String (ISO4 217)

Decimal

M

13,2

Note : SNAP BI Length

(16,2)

Jumlah bersih transaksi. Jika rupiah maka nilainya termasuk 2 angka desimal. misalnya Rp 10.000, akan menjadi 10000.00

10000.00

>currency

String

Alphanumeric

M

3

Mata uang

IDR

beneficiaryAccountNo

String

Numeric

M

15

Note :

SNAP BI

Length

(34)

Rekening penerima

888801000157 508

customerReference

String

Alphanumeric

O

20

Note :

SNAP BI

Length

(30)

Nomor referensi / No Referral / ID transaksi

10052020

feeType

String

Alphanumeric

M

Note :

SNAP BI

(O)

25

Kepada yang dikenai biaya

1. OUR : biaya dibebankan ke pengirim (Default)

2. BEN : biaya dibebankan pada penerima

3. SHA|1000 : biaya dibagi antara pengirim dan penerima, dimana pengirim dikenakan biaya Rp 1.0000,00 dan penerima akan dikenakan biaya selebihnya

BEN
originatorInfos Array of Objects   O   Rincian Akun Pelanggan OriginatorAkan diisi jika ada permintaan dari pengirim atau jika persetujuan dari pengirim telah diberikan  
>originatorCustomerNo String   C 34 Nomor akun originator customer 5550100000
3301
>originatorCustomerName String   C 100 Nama akun originator customer Yuda
>originatorBankCode String   C 8 Kode bank originator  014

remark

String

Alphanumeric

M

Note :

SNAP BI

(O)

40

Note :

SNAP BI

Length

(50)

transaksi

remark test

sourceAccountNo

String

Numeric

M

15

Note :

SNAP BI

Length

(19)

Nomor akun sumber

888801000157 520
transactionDate String Datetime M 25 tangal transaksi : ISO 8601 2021-11-30T10:30:24+07:00

additionalInfo

Object

 

O

 

Additional information

 

>deviceId

String

Alphanumeric

O

 

 

1234579237

>channel

String

Alphanumeric

O

 

 

mobilephone
>isRdn String Boolean O   Dapat diisikan true (untuk rekening RDN) atau false (untuk rekening bukan rdn) true

Response Structure & Sample

 

Field

Data Type

Format

Mandatory

Length

Description

Example

responseCode

String

Numeric

M

7

Response code

2001800

responseMessage

String

Alphanumeric

M

150

Response deskripsi

Successful

referenceNo

String

Numeric

O

Note :

SNAP BI

(C)

14

Note :

SNAP BI

Length

(64)

Identifikasi transaksi pada sistem penyedia layanan. harus dilengkapi setelah transaksi berhasil

20211206000000

partnerReferenceNo

String

Alphanumeric

O

20

Note :

SNAP BI

Length

(64)

Identifikasi transaksi pada sistem layanan konsumen

2020102900000 0000000

amount

Object

 

O

 

 

 

>value

String (ISO4217)

Decimal

M

15,2

Note :

SNAP BI

Length

(16,2)

Jumlah bersih transaksi. Jika rupiah maka nilainya termasuk 2 angka desimal. misalnya Rp 10.000, akan menjadi 10000.00

10000.00

>currency

String

Alphanumeric

M

3

Mata uang

IDR

beneficiaryAccountNo

String

Numeric

M

15

Note :

SNAP BI

Length

(34)

Nomor rekening penerima

8888010001575 08

customerReference

String

Alphanumeric

O

20

Note :

SNAP BI

Length

(30)

No referensi / No Referral

10052020

sourceAccountNo

String

Numeric

O

15

Note :

SNAP BI

Length

(19)

Nomor akun sumber

8888010001575 20

transactionDate

String

Datetime

M

25

tanggal transaksi : ISO 8601

2021-11-30T10: 30:24+07:00
originatorInfos Array of Objects   O   Rincian Akun Pelanggan OriginatorAkan diisi jika ada permintaan dari pengirim atau jika persetujuan dari pengirim telah diberikan  
>originatorCustomerNo String   O 34 Nomor akun originator customer 9990100000 3301
>originatorCustomerName String   O 100 Nama akun originator customer Iin
>originatorBankCode String   O 8 Kode bank originator 002

additionalInfo

Object

 

O

 

 

 

>deviceId

String

Alphanumeric

O

 

 

12345679237

>channel

String

Alphanumeric

O

 

 

mobilephone
>isRdn String Boolean O  

Dapat diisikan true atau false

 true

Request & Response Payload Sample

Request  :

{
    "partnerReferenceNo": "2021112500000000000001",
    "amount": {
        "value": "100000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "888801000157508",
    "customerReference": "10052031",
    "feeType": "BEN",
    "originatorInfos": [
        {
            "originatorCustomerNo": "99901000003301",
            "originatorCustomerName": "Iin"
            "originatorBankCode": "002"
        }
    ],
    "remark": "remark test",
    "sourceAccountNo": "888801000157610",
    "transactionDate": "2021-11-24T10:30:24+07:00",
    "additionalInfo": {}
}

Normal Response :

{
    "responseCode": "2001700",
    "responseMessage": "Successful",
    "referenceNo": "202401250000000006",
    "partnerReferenceNo": "2021112500000000000001",
    "amount": {
        "currency": "IDR",
        "value": "100000.00"
    },
    "originatorInfos": [
        {
            "originatorCustomerNo": "99901000003301",
            "originatorCustomerName": "Iin"
            "originatorBankCode": "002"
        }
    ],
    "beneficiaryAccountNo": "888801000157508",
    "customerReference": "10052031",
    "sourceAccountNo": "888801000157610",
    "transactionDate": "2021-11-24T10:30:24+07:00"
}

Error Response :

{
 "responseCode": "4001701",
 "responseMessage": "Invalid Field Format transactionDate"
}

List of Error/Response Code

HTTP Status

Service Code

Code

Status

Response Description

Deskripsi

200

17

00

Success

Successful

 

202

17

00

Suspend/Need To Check

Request In Progress

Mohon untuk melakukan pengecekan rekening koran untuk melihat status transfer, atau menggunakan endpoint check status

400

17

01

Failed

iInvalid Field Format {fieldName}

 

400

17

02

Failed

 Invalid Mandatory Field {fieldName}

 

401

17

00

Failed

 Unauthoried. [Reason]

 

403

17

02

Failed

 Exceeds Transaction Amount Limit

 

403

17

09

Failed

 Dormant Account

 

403

17

14

Failed

 Insufficient Funds

 

403

17

15

Failed

Transaction Not Permitted. [Reason]

 

403

17

16

Pending

 Suspend Transaction

 

403

17

18

Failed

 Inactive Card/Account/Customer

 

404

17

11

Failed

 Invalid Card/Account/Customer [Info]/Virtual Account

 

404

17

13

Failed

Invalid Amount

 

409

17

00

Pending

Conflict

 

409

17

00

Pending

 Duplicate partnerReferenceNo

 
500 17 00 Pending General Error  
500 17 01 Failed Internal Server Error  
504 17 00 Pending Timeout  
Setiap respons kesalahan yang tidak tercantum dalam daftar respons BRIAPI dianggap pending dan memerlukan penyelidikan lebih lanjut.