API Account Inquiry Internal & Intrabank Transfer

API Information

Title

API Account Inquiry/Intrabank Transfer

Version

v1.0

URL Sandbox

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

URL Production

 

Version Control

API Version

Date

Document Link

Description

v1.0

7 December

This Pages

Baseline version

v2.0

12 April 2021

This Pages

Update Field Format

v2.1

19 September 2022

This Pages

Update RC & example Field

Product Description

Product Overview

This feature is used for overbooking of funds sourced from PJP PIAS account via credit transfer service on PJP AIS Bank using API intrabank transfer

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

This endpoint is used to validate the number and name of the destination account before making an intrabank transfer.

General Information

HTTP Method

POST

Path

/intrabank/snap/v1.0/account-inquiryinternal

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)

Beneficiary Account Number

888801000157

508

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 Message

Successful

referenceNo

String

Numeric

O

Note : SNAP BI

(C)

7

Note : SNAP BI

length (64)

Identification of transactions in the service provider system. must be completed after the transaction is successful  after the transaction is successful

 

2021112

 

beneficiaryAccountName

String

Alphanumeric

M

100

Beneficiary Account Name

John Doe

beneficiaryAccountNo

String

Numeric

M

15

Note : SNAP BI

length (34)

Beneficiary Account Number

88880100015

7508

beneficiaryAccountStatus

String

Alphanumeric

O

16

Beneficiary Account Status

Rekening Aktif

beneficiaryAccountType

String

Alphanumeric

O

1

Beneficiary Account Type

“D” for Current Account “S” for Saving Account

S

currency

String

Alphanumeric

O

3

Currency

IDR

additionalInfo

Object

 

O

 

 

 

>channel

String

Alphanumeric

O

 

 

mobilephone

>deviceId

String

Alphanumeric

O

 

 

12345679237

Request & Response Payload Sample

Request :

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

Normal Response :

	
        {
            "responseCode": "2001500",
            "responseMessage": "Successful",
            "referenceNo": "2021112",
            "beneficiaryAccountNo": "888801000157508",
            "beneficiaryAccountName": "John Doe",
            "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

Description

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

 

403

15

09

Failed

Dormant

Account

 

403

15

18

Failed

Inactive Card/Account/Customer

 

404

15

11

Failed

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

 

500

15

00

Pending

General Erorr

 

504

15

00

Pending

Timeout

 

B. Transfer Intrabank

This endpoint is used to make fund transfers from the accounts of Non-PJP Service Users, PJP PIAS, or PJP AIS Non-Bank Institutions to the destination account at one PJP AIS Bank.

General Information

HTTP Method

POST

Path

/intrabank/snap/v1.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)

Identification of transactions in the customer service system

202010290000

0000000001

amount

Object

 

O

 

 

 

>value

String (ISO4 217)

Decimal

M

15,2

Note : SNAPBI

Length (16,2)

Net amount of the transaction. If it’s IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00

10000.00

>currency

String

Alphanumeric

M

3

Currency

IDR

beneficiaryAccountNo

String

Numeric

M

15

Note : SNAP BI

Length (34)

Beneficiary Account

888801000157

508

customerReference

String

Alphanumeric

M

Note:

SNAPBI

(O)

20

Note: SNAPBI

Length (30)

Reference Number / Referral Number / Transaction ID

10052020

feeType

String

Alphanumeric

M

Note : 

SNAP BI

(O)

25

to whom the fee will be charged

1. OUR Fee is charged to the sender (default)

2. BEN Fee is charged to the recipient

3. SHA|1000 Fee is shared between sender and recipient, with sender is charged Rp 1.000,00 and the recipient will be charged the rest

BEN

remark

String

Alphanumeric

M

Note :

SNAP BI

(O)

40

Note : SNAP BI

Length (50)

Transaction

remark test

sourceAccountNo

String

Numeric

M

15

Note : SNAP BI

Length (19)

Source Account Number

888801000157

520

transactionDate

String

Dateime

M

25

transaction date : ISO 8601

2021-11-

30T10:30:

24+07:00

additionalInfo

Object

 

O

 

Additional Information

 

>deviceId

String

Alphanumeric

O

 

 

12345679237

>channel

String

Alphanumeric

O

 

 

mobilephone

Response Structure & Sample

Field

Data Type

Format

Mandatory

Length

Description

Example

responseCode

 

String

Numeric

M

7

Response

code

2001700

responseMessage

String

Alphanumeric

M

150

Response

description

Successful

referenceNo

String

Numeric

O

Note :

SNAP BI

(C)

14

Note : SNAP BI

Length (64)

Identification of transaction s in the

service

provider system. must be completed after the transaction is

successful

 

202112060

00000

partnerReferenceNo

String

Alphanumeric

 

O

20

Note : SNAP BI

Length (64)

Transaction identifier on service consumer

system

 

202010290

000000000

00

amount

Object

 

O

 

 

 

>value

String (ISO4217)

Decimal

M

15,2

Note : SNAP BI

Length (16,2)

Net amount of the transaction. If it’s IDR then value includes 2 decimal digits. e.g. IDR 10.000,-

will be placed with 10000.00

 

10000.00

>currency

String

Alphanumeric

M

3

Currency

IDR

beneficiaryAccountNo

String

Numeric

M

15

Note : SNAP BI

Length (34)

Beneficiary Account Number

 

888801000

157508

customerReference

String

Alphanumeric

O

20

Note : SNAP BI

Length (30)

Reference Number / Referral

Number

 

10052020

sourceAccountNo

String

Numeric

O

15

Note : SNAP BI

Length (19)

Source Account Number

 

888801000

157520

transactionDate

String

Datetime

M

25

transaction date : ISO

8601

2021-11-

30T10:30:2

4+07:00

additionalInfo

Object

 

O

 

Additional information

 

>deviceId

String

Alphanumeric

O

 

 

123456792

37

>channel

String

Alphanumeric

O

 

 

mobilepho

ne

Request & Response Payload Sample

Request :

{

 "partnerReferenceNo": "2021113000000000000",

 "amount": {

 "value": "100000.00",

 "currency": "IDR"

 },

 "beneficiaryAccountNo": "888801000157508",

 "customerReference": "10052020",

 "feeType": "BEN",

 "remark": "remark test",

 "sourceAccountNo": "888801000157520",

 "transactionDate": "2021-11-30T10:30:24+07:00",

 "additionalInfo": {

 "deviceId": "12345679237",

 "channel": "mobilephone"

 }

}
	

Normal Response :

{

 "responseCode": "2001700",

 "responseMessage": "Successful",

 "referenceNo": "20211206000000",

 "partnerReferenceNo": "2021113000000000000",

 "amount": {

 "currency": "IDR",

 "value": "100000.00"

 },

 "beneficiaryAccountNo": "888801000157508",

 "customerReference": "10052020",

 "sourceAccountNo": "888801000157520",

 "transactionDate": "2021-11-30T10:30:24+07:00",

 "additionalInfo": {

 "channel": "mobilephone",

 "deviceId": "12345679237"

 }

}

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

 

400

17

01

Failed

Invalid Field Format {fieldName}

 

400

17

02

Failed

Invalid Mandatory Field {fieldName}

 

401

17

00

Failed

Unauthorized. Client

 

403

17

02

Failed

Exceeds Transaction Amount Limit

 

403

17

09

Failed

Domant 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

Failed

Conflict

 

409

17

01

Failed

Duplicate partnerReferenceNo

 

500

17

00

Pending

General Erorr

 

504

17

00

Pending

Timeout