API Trigger Transfer/RTGS Transfer v2.0 API Information
API Information
Title |
API Transfer RTGS v2.0 |
---|---|
Version |
v2.0 |
URL Sandbox |
|
URL Production |
Version Control
Doc Version |
Tanggal |
Link Dokumen |
Deskripsi |
---|---|---|---|
v1.0 |
15 Feb 2023 |
this page. |
Baseline version |
Product Description
Product Overview
This feature is used to perform transfer instructions via RTGS, with transaction and daily limits that have been set in advance, including additional support for RDN accounts.
Endpoint
A. API Trigger Transfer / RTGS Transfer
General Information
HTTP Method |
POST |
---|---|
Path |
/rtgs/snap/v2.0/transfer-rtgs |
Tipe Format |
JSON |
Authentication |
OAuth 2.0 with Access Token |
Header Structure
Key |
Value |
Format |
Mandatory |
Length |
Description |
---|---|---|---|---|---|
Authorization |
Authorization |
String |
M |
|
Bearer {Token} |
X-TIMESTAMP |
BRI - Timestamp |
Datetime |
M |
|
Format Timestamp ISO8601 |
X-SIGNATURE |
BRI - 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 |
|
Request Structure
Field | Data Type | Format | Mandatory | Length | Description |
---|---|---|---|---|---|
partnerReferenceNo | String | Alphanumeric | M |
20
Note: SNAP BI Length (64) |
Transaction identification in the consumer services system |
customerReference | String | Alphanumeric | O |
20
Note: Length SNAP BI (30) |
Reference number / Referral number / Transaction ID |
sourceAccountNo | String | Numeric | M |
15 Note: Length SNAP BI (19) |
Sender’s account number |
feeType | String | Alphanumeric | M | 25 |
Types of fee charges that can be used by partners include: • OUR: the fee is charged to the sender / institution (default) • BEN: the fee is charged to the recipient • SHA|1000: the fee is shared between the sender and recipient, with the recipient being charged 1000 and the sender covering the remaining fee |
senderCustomerType | String | Numeric | M | 1 | Sender’s customer type: 1. Individual 2. Company 3. Government |
senderCustomerResidence | String | Numeric | M | 1 |
Sender residency statuses that can be used include: 1: Indonesian citizen 2: Foreign citizen |
senderPhone | String | Numeric | O | 20 | Sender’s mobile/telephone number |
beneficiaryBankCode | String | Alphanumeric | M | 8 | Beneficiary bank code |
beneficiaryAccountNo | String | Numeric | M | 34 | Beneficiary’s account number |
beneficiaryAccountName | String | Alphanumeric | M | 100 | Beneficiary’s account name |
receiverIdentity | String | Numeric | M | 16 | Beneficiary’s identity number |
beneficiaryCustomerType | String | Numeric | M | 1 | Beneficiary’s customer type: 1. Individual 2. Company 3. Government |
beneficiaryCustomerResidence | String | Numeric | M | 1 | Citizenship status: 1: Indonesian 2: Non-Indonesian |
beneficiaryAddress | String | Alphanumeric | M | 150 | Beneficiary’s address |
receiverPhone | String | Numeric | O | 20 | Beneficiary’s mobile/telephone number |
amount | Object | O | Detail is shown in the amount object table below | ||
>value | String | Decimal | M | 18,2 | Net transaction amount. If in Rupiah includes two decimal places, e.g., Rp 10,000 is 10000.00; max e.g. 500000000.00 |
>currency | String | Alphanumeric | M | 3 | Transaction currency |
remark | String | Alphanumeric | M |
40 Note: Length SNAP BI (50) |
Transaction description |
beneficiaryBankName | String | Alphanumeric | O | 50 | Beneficiary bank name |
transactionDate | String | Datetime | M | 25 | Transaction date and time (ISO 8601) |
additionalInfo | Object |
M
Note: SNAP BI (O) |
Details are shown in the additionalInfo object below | ||
>deviceId | String | Alphanumeric | O | - | |
>channel | String | Alphanumeric | O | - | |
>senderName | String | Alphanumeric | M | 100 | Sender’s name |
>senderIdentity | String | Numeric | M | 16 | Sender’s identity number |
>senderAddress | String | Alphanumeric | M | 150 | Sender’s address |
>senderPosCode | String | Numeric | O | 10 | Sender’s postal code |
>receiverPosCode | String | Numeric | O | 10 | Beneficiary’s postal code |
>corporateType | String | Numeric | M | 1 |
Business type:
|
>isRdn | String | Boolean | O | - | True / False |
originatorInfos | Array Object | O |
Details of the sender’s account.
To be filled if requested by the sender or with sender’s consent.
This follows Article 8 paragraph 5 of Indonesian Law No. 3 of 2011 on Funds Transfer.
Also check other applicable regulations, such as PPATK. |
||
>originatorCustomerNo | String | - | O | 100 | Originator’s account number |
>originatorCustomerName | String | - | O | 8 | Originator’s customer name |
>originatorBankCode | String | - | O | 50 | Originator’s bank code |
Response Structure & Sample
Field | Data Type | Format | Mandatory | Length | Description | Example |
---|---|---|---|---|---|---|
responseCode | String | Numeric | M | 7 | Response code | 2002200 |
responseMessage | String | Alphanumeric | M | 150 |
Description of response message |
Successful |
referenceNo | String | Numeric | O Note : SNAP BI (C) |
7 Note : Length SNAP BI (64) |
Transaction identifier in the service provider's system. Must be filled in after the transaction is successful |
7061005 |
amount | Object | O |
Details of the Object amount field are provided in the row below |
|||
>value | String | Decimal | M | 18,2 Note : Length SNAP BI (16,2) |
Net amount of the transaction. If in Rupiah, it includes 2 decimal digits, for example Rp 10,000 is represented as 10000.00 |
101000000.00 |
>currency | String | Alphanumeric | M | 3 |
Transaction currency |
IDR |
beneficiaryAccountName | String | Alphanumeric | M | 100 |
Beneficiary account name |
John Doe |
beneficiaryAccountNo | String | Numeric | M | 34 |
Beneficiary account number |
9876543210123456 |
beneficiaryBankCode | String | Alphanumeric | O | 8 |
Beneficiary bank code |
BMRIIDJA |
customerReference | String | Alphanumeric | O | 20 |
Reference number / Referral No / Transaction ID |
TRX202506100845 |
sourceAccountNo | String | Numeric | M | 15 Note : Length SNAP BI (19) |
Recipient bank code |
123456789012345 |
transactionDate | String | Datetime | M | 25 |
Transaction date: dd-MM-yyyy (Mandatory) HH:mm:ss (Optional) |
2023-02-13T15:10:56+07:00 |
transactionStatus | String | Numeric | M | 2 | 00 - Success 01 - Initiated 02 - Paying 03 - Pending 04 - Refunded 05 - Canceled 06 - Failed 07 - Not Found |
01 |
transactionStatusDesc | String | Alphanumeric | O | 50 |
Details of the Object additionalInfo field are provided in the row below |
Transaction success to initiate |
additionalInfo | Object | M Note : SNAP BI (O) |
The details of the additionalInfo object are provided in the rows below. | |||
>deviceId | String | Alphanumeric | O | 12345679237 | ||
>channel | String | Alphanumeric | O | mobilephone | ||
>senderName | String | Alphanumeric | M | 100 |
Sender's name |
Latifah Hanum |
>senderIdentity | String | Numeric | M | 16 |
Identity number |
315205100190093 |
>senderAddress | String | Alphanumeric | M | 150 |
Sender's address |
Jakarta Selatan |
>corporateType | String | Numeric | M | 1 | Business type includes 1. conventional 2. sharia |
1 |
>isRdn | String | boolean | O | true / false | false | |
originatorInfos | Array Object | O |
Details of the sender’s account.
To be filled if requested by the sender or with sender’s consent.
This follows Article 8 paragraph 5 of Indonesian Law No. 3 of 2011 on Funds Transfer.
Also check other applicable regulations, such as PPATK. |
|||
>originatorCustomerNo | String | O | 100 |
Originator account number |
99901000003302 | |
>originatorCustomerName | String | O | 8 |
Originator customer name |
Rid | |
>originatorBankCode | String | O | 50 |
Originator bank code |
003 |
Request & Response Payload Sample
Request
{ "partnerReferenceNo": "202506100000001", "amount": { "value": "5000000.00", "currency": "IDR" }, "beneficiaryAccountName": "John Doe", "beneficiaryAccountNo": "1234567890123456", "beneficiaryAddress": "Jakarta Selatan", "beneficiaryBankCode": "BMRIIDJA", "beneficiaryBankName": "Bank Mandiri", "beneficiaryCustomerResidence": "1", "beneficiaryCustomerType": "1", "beneficiaryEmail": "john.doe@example.com", "currency": "IDR", "customerReference": "REF12345678", "feeType": "OUR", "kodepos": "12940", "receiverPhone": "081234567890", "remark": "Test transfer dummy", "senderCustomerResidence": "1", "senderCustomerType": "1", "senderPhone": "081234567890", "sourceAccountNo": "999901000000123", "originatorInfos": [ { "originatorCustomerNo": "99901000000001", "originatorCustomerName": "Luke Sky", "originatorBankCode": "014" }, { "originatorCustomerNo": "99901000000002", "originatorCustomerName": "Leia Organa", "originatorBankCode": "022" }, { "originatorCustomerNo": "99901000000003", "originatorCustomerName": "Ben Kenobi", "originatorBankCode": "009" } ], "transactionDate": "2025-06-10T10:00:00+07:00", "additionalInfo": { "deviceId": "DEV123456789", "channel": "mobile", "senderName": "Test Sender", "senderIdentity": "KTP123456789", "senderAddress": "Jl. Mawar No. 123, Jakarta", "corporateType": "1", "isRdn": "false" } }
Normal Response
{ "responseCode": "2002200", "responseMessage": "Successful", "partnerReferenceNo": "202506100000001", "amount": { "value": "5000000.00", "currency": "IDR" }, "beneficiaryAccountName": "John Doe", "beneficiaryAccountNo": "1234567890123456", "beneficiaryBankCode": "BMRIIDJA", "sourceAccountNo": "999901000000123", "transactionDate": "2025-06-10T10:00:00+07:00", "additionalInfo": { "senderName": "Test Sender", "senderIdentity": "KTP123456789", "senderAddress": "Jl. Mawar No. 123, Jakarta", "corporateType": "1", "isRdn": "false" }, "originatorInfos": [ { "originatorCustomerNo": "99901000000001", "originatorCustomerName": "Luke Sky", "originatorBankCode": "014" }, { "originatorCustomerNo": "99901000000002", "originatorCustomerName": "Leia Organa", "originatorBankCode": "022" }, { "originatorCustomerNo": "99901000000003", "originatorCustomerName": "Ben Kenobi", "originatorBankCode": "009" } ] }
Error Response :
{ "responseCode": "4001801", "responseMessage": "Invalid Field Format transactionDate" }
List of Error/Response Code
HTTP Status |
Service Code |
Case Code |
Status |
Response Message |
Description |
---|---|---|---|---|---|
200 | 22 | 00 | Sukses | Successful | |
400 | 22 | 02 | Gagal | Invalid Mandatory Field {fieldName} | |
400 | 22 | 01 | Gagal | Invalid Field Format {fieldName} | |
401 | 22 | 00 | Gagal | Unauthorized [Reason] | |
403 | 22 | 02 | Gagal | Exceeds Transaction Amount Limit | |
403 | 22 | 00 | Gagal | Transaction Expired | |
403 | 22 | 09 | Gagal | Dormant Account | |
403 | 22 | 14 | Gagal | Insufficient Funds | |
403 | 22 | 15 | Gagal | Transaction Not Permitted [Reason] | |
403 | 22 | 16 | Pending | Suspend Transaction | |
403 | 22 | 18 | Gagal | Inactive Card/Account/Customer | |
404 | 22 | 11 | Gagal | Invalid Card/Account/ [info]/Virtual Account |
|
404 | 22 | 13 | Gagal | Invalid Amount | |
404 | 22 | 00 | Gagal | Invalid Transaction Status | |
404 | 22 | 01 | Gagal | Transaction Not Found | |
409 | 22 | 01 | Gagal | Duplicate partnerReferenceNo | |
409 | 22 | 00 | Gagal | Conflict | |
500 | 22 | 00 | Pending | General Error | |
500 | 22 | 01 | Pending | Internal Server Error | |
504 | 22 | 00 | Pending | Timeout |
B. Get BIC Code
General Information
HTTP Method |
POST |
---|---|
Path |
/rtgs/snap/v2.0/transfer-rtgs |
Tipe Format |
JSON |
Authentication |
OAuth 2.0 with Access Token |
Header Structure
Key |
Value |
Format |
Mandatory |
Length |
Description |
---|---|---|---|---|---|
Authorization |
Authorization |
String |
M |
|
Bearer {Token} |
X-TIMESTAMP |
BRI - Timestamp |
Datetime |
M |
|
Format Timestamp ISO8601 |
X-SIGNATURE |
BRI - 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 |
Request Structure
Field | Data Type | Format | Mandatory | Length | Description |
---|---|---|---|---|---|
partnerReferenceNo | String | Alphanumeric | M |
20
Note: SNAP BI Length (64) |
Identification of transactions on the service provider system |
additionalInfo | Object |
M
Note: SNAP BI (O) |
Details are shown in the additionalInfo object below |
Request Structure dalam "additionalInfo"
Field | Data Type | Format | Mandatory | Length | Description | Example |
---|---|---|---|---|---|---|
deviceId | String | Alphanumeric | O | - | 12345679237 | |
channel | String | Alphanumeric | O | - | Mobile |
Response Structure & Sample
Field | Data Type | Format | Mandatory | Length | Description | Example |
---|---|---|---|---|---|---|
responseCode | String | Numeric | M | 7 | Response code | 2002200 |
responseMessage | String | Alphanumeric | M | 150 | Description of response message | Successful |
detailData | Array Object | M | ||||
additionalInfo | Object |
M
Note: SNAP BI (O) |
Response Structure dalam "detailData"
Field | Data Type | Format | Mandatory | Length | Description | Example |
---|---|---|---|---|---|---|
bankCode | String | Alphanumeric | M | 8 |
Recipient Bank Code |
CENAIDJA |
bankName | String | Alphanumeric | M | 100 | Recipient Bank Name | Rine |
Response Structure dalam "additionalInfo"
Field | Data Type | Format | Mandatory | Length | Description | Example |
---|---|---|---|---|---|---|
deviceId | String | Alphanumeric | O | - | 12345679237 | |
channel | String | Alphanumeric | O | - | Mobile |
Request & Response Payload Sample
Request
{ "partnerReferenceNo": "1234532142323", "additionalInfo": { "deviceId": "12345679237", "channel": "mobilephone" } }
Normal Response
{ "responseCode": "2002200", "responseMessage": "Successful", "detailData": [ { "bankCode": "SYHSIDJ1", "bankName": "HONGKONG AND SHANGHAI BANK CORPORATION UUS" }, { "bankCode": "LPEIIDJ1", "bankName": "INDONESIA EXIMBANK" }, { "bankCode": "BLPSIDJ1", "bankName": "Lembaga Penjamin Simpanan" }, { "bankCode": "ATJSIDJ2", "bankName": "PT. ARTAJASA PEMBAYARAN ELEKTRONIS" }, { "bankCode": "FINBIDJA", "bankName": "PT. BANK AGRIS" }, { "bankCode": "KOEXIDJA", "bankName": "PT. BANK KEB INDONESIA" }, { "bankCode": "SYTPIDJ1", "bankName": "PT. BANK TABUNGAN PENSIUNAN NASIONAL UUS" }, { "bankCode": "SYNBIDJ1", "bankName": "PT. BPD NUSA TENGGARA BARAT UUS" }, { "bankCode": "SYRIIDJ1", "bankName": "PT. BPD RIAU DAN KEPRI UUS" }, { "bankCode": "FINTIDJ1", "bankName": "PT. FINNET INDONESIA" }, { "bankCode": "SKNAIDJ1", "bankName": "SKN CLEARING CREDIT 1" }, { "bankCode": "SKNAIDJ2", "bankName": "SKN CLEARING CREDIT 2" }, { "bankCode": "PDWSIDJA", "bankName": "PT. BANK SULSELBAR" }, { "bankCode": "SYATIDJ1", "bankName": "PT. BANK JAGO TBK UNIT USAHA SYARIAH" }, { "bankCode": "NETBIDJA", "bankName": "PT BANK ALADIN SYARIAH, TBK." }, { "bankCode": "BPIAIDJA", "bankName": "PT. BANK RESONA PERDANIA" }, { "bankCode": "CTCBIDJA", "bankName": "PT. BANK CTBC INDONESIA" }, { "bankCode": "DEUTIDJA", "bankName": "DEUTSCHE BANK AG." }, { "bankCode": "PDWGIDJ1", "bankName": "PT. BPD SULAWESI TENGAH" }, { "bankCode": "MEDHIDS1", "bankName": "PT. BANK MESTIKA DHARMA" }, { "bankCode": "PDRIIDJA", "bankName": "PT. BANK PEMBANGUNAN DAERAH RIAU KEPRI SYARIAH (PERSERODA)" }, { "bankCode": "BSMDIDJA", "bankName": "PT. BANK SYARIAH INDONESIA Tbk." }, { "bankCode": "PDJTIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH JATIM" }, { "bankCode": "PDNBIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH NUSA TENGGARAT BARAT SYARIAH" }, { "bankCode": "BIDXIDJA", "bankName": "BANK INDEX SELINDO" }, { "bankCode": "MAYAIDJA", "bankName": "PT. BANK MAYAPADA Tbk." }, { "bankCode": "PDBKIDJ1", "bankName": "PT. BPD BENGKULU" }, { "bankCode": "SYJTIDJ1", "bankName": "BANK JATIM UNIT USAHA SYARIAH" }, { "bankCode": "BSDRIDJA", "bankName": "PT. BANK WOORI SAUDARA INDONESIA 1906,TBK" }, { "bankCode": "PDLPIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH LAMPUNG" }, { "bankCode": "SYCAIDJ1", "bankName": "PT. BANK BCA SYARIAH" }, { "bankCode": "PDWUIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH SULUT" }, { "bankCode": "BSSPIDSP", "bankName": "PT. BPD SUMSEL DAN BABEL" }, { "bankCode": "SYJMIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH JAMBI UUS" }, { "bankCode": "PDJMIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH JAMBI" }, { "bankCode": "PDKGIDJ1", "bankName": "PT. BPD KALIMANTAN TENGAH" }, { "bankCode": "SYSSIDJ1", "bankName": "PT. BPD SUMSEL DAN BABEL UNIT USAHA SYARIAH" }, { "bankCode": "INDOIDJA", "bankName": "BANK INDONESIA" }, { "bankCode": "SYWSIDJ1", "bankName": "PT. BANK SULSELBAR UNIT USAHA SYARIAH" }, { "bankCode": "PDBBIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH BANTEN" }, { "bankCode": "SWAGIDJ1", "bankName": "PT. BANK VICTORIA SYARIAH" }, { "bankCode": "SUNIIDJA", "bankName": "PT. Bank BTPN, Tbk." }, { "bankCode": "SYBBIDJ1", "bankName": "PT. BANK PERMATA,TBK UNIT USAHA SYARIAH" }, { "bankCode": "CHASIDJX", "bankName": "KC JPMORGAN CHASE BANK, N.A" }, { "bankCode": "CITIIDJX", "bankName": "CITIBANK, NA" }, { "bankCode": "PDIJIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH PAPUA" }, { "bankCode": "PDMLIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH MALUKU DAN MALUKU UTARA" }, { "bankCode": "ARTGIDJA", "bankName": "PT. BANK ARTHA GRAHA INTERNASIONAL, TBK" }, { "bankCode": "BKCHIDJA", "bankName": "BANK OF CHINA (HONG KONG) LIMITED" }, { "bankCode": "PDSUIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH SUMUT" }, { "bankCode": "SSPIIDJA", "bankName": "PT. BANK SEABANK INDONESIA" }, { "bankCode": "BDKIIDJ1", "bankName": "PT. BANK DKI" }, { "bankCode": "SYDKIDJ1", "bankName": "PT. BANK DKI UNIT USAHA SYARIAH" }, { "bankCode": "MASDIDJ1", "bankName": " PT. BANK MASPION" }, { "bankCode": "HSBCIDJA", "bankName": "PT. BANK HSBC INDONESIA" }, { "bankCode": "AWANIDJA", "bankName": "PT. BANK QNB INDONESIA,TBK" }, { "bankCode": "SYBTIDJ1", "bankName": "PT. BANK TABUNGAN NEGARA (PERSERO) UNIT USAHA SYARIAH" }, { "bankCode": "BUTGIDJ1", "bankName": "PT. BANK MEGA SYARIAH" }, { "bankCode": "LMANIDJ1", "bankName": "PT. BANK OKE INDONESIA, TBK" }, { "bankCode": "AGTBIDJA", "bankName": "PT. BANK RAYA INDONESIA, TBK" }, { "bankCode": "FAMAIDJ1", "bankName": "PT SUPER BANK INDONESIA" }, { "bankCode": "BBBAIDJA", "bankName": "PT. BANK PERMATA,TBK" }, { "bankCode": "IAPTIDJA", "bankName": "PT. BANK INA PERDANA, Tbk" }, { "bankCode": "SIHBIDJ1", "bankName": "PT. BANK MANDIRI TASPEN " }, { "bankCode": "CENAIDJA", "bankName": "PT. BANK CENTRAL ASIA Tbk." }, { "bankCode": "BMSEIDJA", "bankName": "PT. BANK MULTIARTA SENTOSA TBK" }, { "bankCode": "PDNTIDJA", "bankName": "PT.BANK PEMBANGUNAN DAERAH NTT" }, { "bankCode": "BCIAIDJA", "bankName": "PT BANK CAPITAL INDONESIA" }, { "bankCode": "MAYOIDJA", "bankName": "PT. BANK HIBANK INDONESIA" }, { "bankCode": "BBUKIDJA", "bankName": "PT. BANK KB BUKOPIN Tbk." }, { "bankCode": "CICTIDJA", "bankName": "PT. BANK JTRUST INDONESIA, TBK" }, { "bankCode": "BUSTIDJ1", "bankName": "PT KROM BANK INDONESIA Tbk" }, { "bankCode": "BBLUIDJA", "bankName": "PT Bank Digital BCA" }, { "bankCode": "IBKOIDJA", "bankName": "PT BANK IBK INDONESIA TBK" }, { "bankCode": "SYSUIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH SUMUT UUS" }, { "bankCode": "MEEKIDJ1", "bankName": "PT. BANK SHINHAN INDONESIA" }, { "bankCode": "HRDAIDJ1", "bankName": "PT ALLO BANK INDONESIA TBK" }, { "bankCode": "ICBKIDJA", "bankName": "PT. BANK ICBC INDONESIA" }, { "bankCode": "BRINIDJA", "bankName": "PT. BANK RAKYAT INDONESIA (PERSERO)" }, { "bankCode": "SYBKIDJ1", "bankName": "PT. BANK MAYBANK INDONESIA Tbk. UNIT USAHA SYARIAH" }, { "bankCode": "PINBIDJA", "bankName": "PT. PANIN BANK Tbk." }, { "bankCode": "MCORIDJA", "bankName": "PT. BANK CHINA CONSTRUCTION BANK INDONESIA, TBK" }, { "bankCode": "MEGAIDJA", "bankName": "PT. BANK MEGA Tbk." }, { "bankCode": "SYNAIDJ1", "bankName": "PT. BANK CIMB NIAGA TBK - UNIT USAHA SYARIAH" }, { "bankCode": "SYONIDJ1", "bankName": "PT.BANK OCBC NISP TBK - UNIT USAHA SYARIAH" }, { "bankCode": "SYTBIDJ1", "bankName": "PT. BANK SINARMAS UNIT USAHA SYARIAH" }, { "bankCode": "BOTKIDJX", "bankName": "MUFG Bank, Ltd." }, { "bankCode": "SYBDIDJ1", "bankName": "PT. BANK DANAMON INDONESIA UNIT USAHA SYARIAH" }, { "bankCode": "NISPIDJA", "bankName": "PT. BANK OCBC NISP, Tbk." }, { "bankCode": "ANZBIDJX", "bankName": "PT. BANK ANZ INDONESIA" }, { "bankCode": "BDINIDJA", "bankName": "PT. BANK DANAMON INDONESIA Tbk." }, { "bankCode": "GNESIDJA", "bankName": "PT. BANK GANESHA" }, { "bankCode": "HNBNIDJA", "bankName": "PT. BANK KEB HANA INDONESIA" }, { "bankCode": "IBBKIDJA", "bankName": "PT. BANK MAYBANK INDONESIA Tbk." }, { "bankCode": "LFIBIDJ1", "bankName": "PT. BANK NATIONALNOBU" }, { "bankCode": "MHCCIDJA", "bankName": "PT. BANK MIZUHO INDONESIA" }, { "bankCode": "PUBAIDJ1", "bankName": "PT BANK BTPN SYARIAH,TBK" }, { "bankCode": "YUDBIDJ1", "bankName": "PT. BANK NEO COMMERCE, TBK" }, { "bankCode": "BBAIIDJA", "bankName": "PT. BANK BUMI ARTA" }, { "bankCode": "BBIJIDJA", "bankName": "PT. BANK UOB INDONESIA" }, { "bankCode": "BICNIDJA", "bankName": "PT. BANK COMMONWEALTH" }, { "bankCode": "PDYKIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH DIY" }, { "bankCode": "ARFAIDJ1", "bankName": "PT. BANK PANIN DUBAI SYARIAH" }, { "bankCode": "BNPAIDJA", "bankName": "PT. BANK BNP PARIBAS INDONESIA" }, { "bankCode": "SYACIDJ1", "bankName": "PT. BANK ACEH SYARIAH" }, { "bankCode": "SWBAIDJ1", "bankName": "PT. BANK OF INDIA INDONESIA, TBK" }, { "bankCode": "SDOBIDJ1", "bankName": "PT BANK KB BUKOPIN SYARIAH" }, { "bankCode": "VICTIDJ1", "bankName": "PT. BANK VICTORIA INTERNATIONAL" }, { "bankCode": "PDSBIDJ1", "bankName": "PT. BANK NAGARI" }, { "bankCode": "PDKBIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH KALBAR" }, { "bankCode": "PDJBIDJA", "bankName": "PT. BANK PEMBANGUNAN DAERAH JABAR DAN BANTEN" }, { "bankCode": "SYKBIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH KALBAR UUS" }, { "bankCode": "JSABIDJ1", "bankName": "PT. BANK JASA JAKARTA" }, { "bankCode": "IDMOIDJ1", "bankName": "PT. BANK SBI INDONESIA" }, { "bankCode": "BOFAID2X", "bankName": "BANK OF AMERICA NA" }, { "bankCode": "BNIAIDJA", "bankName": "PT. BANK CIMB NIAGA TBK" }, { "bankCode": "MUABIDJA", "bankName": "PT. BANK MUAMALAT INDONESIA" }, { "bankCode": "SBJKIDJA", "bankName": "PT. BANK SINARMAS" }, { "bankCode": "BTANIDJA", "bankName": "PT. BANK TABUNGAN NEGARA (PERSERO)" }, { "bankCode": "BUMIIDJA", "bankName": "PT. BANK MNC INTERNASIONAL, TBK" }, { "bankCode": "LOMAIDJ1", "bankName": "PT. BANK AMAR INDONESIA" }, { "bankCode": "BMRIIDJA", "bankName": "PT. BANK MANDIRI (PERSERO) TBK" }, { "bankCode": "BNINIDJA", "bankName": "PT. BANK NEGARA INDONESIA (PERSERO)" }, { "bankCode": "DBSBIDJA", "bankName": "PT. BANK DBS INDONESIA" }, { "bankCode": "SYSBIDJ1", "bankName": "PT. BANK NAGARI - UNIT USAHA SYARIAH" }, { "bankCode": "PDKSIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH KALSEL" }, { "bankCode": "SYKSIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH KALSEL - UNIT USAHA SYARIAH" }, { "bankCode": "PDWRIDJ1", "bankName": "PT. BPD SULAWESI TENGGARA" }, { "bankCode": "SCBLIDJX", "bankName": "STANDARD CHARTERED BANK" }, { "bankCode": "ABALIDBS", "bankName": "PT. BANK PEMBANGUNAN DAERAH BALI" }, { "bankCode": "PDJGIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH JAWA TENGAH" }, { "bankCode": "SYJGIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH JATENG UNIT USAHA SYARIAH " }, { "bankCode": "SYJBIDJ1", "bankName": "PT. BANK JABAR BANTEN SYARIAH" }, { "bankCode": "SYYKIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH DIY UNIT USAHA SYARIAH" }, { "bankCode": "PDKTIDJ1", "bankName": "PT. BANK PEMBANGUNAN DAERAH KALTIM DAN KALTARA" }, { "bankCode": "SYKTIDJ1", "bankName": "PT.BANK PEMBANGUNAN DAERAH KALTIM DAN KALTARA-UNIT USAHA SYARIAH" }, { "bankCode": "JAGBIDJA", "bankName": "PT. BANK JAGO, Tbk" }, { "bankCode": "SAHMIDJA", "bankName": "PT. BANK SAHABAT SAMPOERNA" }, { "bankCode": "KATALON1", "bankName": "PT. BANK QNB KESAWAN" } ], "additionalInfo": { "deviceId": "12345679237", "channel": "mobilephone" } }
Error Response :
{ "responseCode": "4002202", "responseMessage": "Invalid Mandatory Field partnerReferenceNo" }
List of Error/Response Code
HTTP Status |
Service Code |
Code |
Status |
Response Message |
Description |
---|---|---|---|---|---|
200 |
22 |
00 |
Sukses |
Successful |
|
400 |
22 |
02 |
Gagal |
Invalid Mandatory Field {fieldName} |
|
400 |
22 |
01 |
Gagal |
Invalid Field Format {fieldName} |
|
409 |
22 |
00 |
Gagal |
Conflict |
|
500 |
22 |
00 |
Pending |
General Error |
|
500 |
22 |
01 |
Pending |
Internal Server Error |
|
504 |
22 |
00 |
Pending |
Timeout |
C. Inquiry Beneficiary Account
General Information
HTTP Method |
POST |
---|---|
Path |
/rtgs/snap/v2.0/inquiry-account-rtgs |
Tipe Format |
JSON |
Authentication |
OAuth 2.0 with Access Token |
Header Structure
Key |
Value |
Format |
Mandatory |
Length |
Description |
---|---|---|---|---|---|
Authorization |
Authorization |
String |
M |
|
Bearer {Token} |
X-TIMESTAMP |
BRI - Timestamp |
Datetime |
M |
|
Format Timestamp ISO8601 |
X-SIGNATURE |
BRI - 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 |
Request Structure
Field | Data Type | Format | Mandatory | Length | Description | |
---|---|---|---|---|---|---|
beneficiaryBankCode | String | Alphanumeric | M | 8 | Destination Bank Code | |
beneficiaryAccountNo | String | Numeric | M | 34 |
ther destination bank account for the transaction |
|
additionalInfo | Object | O |
Additional information included consists of: |
Response Structure dalam "additionalInfo"
Field | Data Type | Format | Mandatory | Length | Description | Example |
---|---|---|---|---|---|---|
deviceId | String | Alphanumeric | O | - | 12345679237 | |
channel | String | Alphanumeric | O | - | Mobile |
Response Structure & Sample
Field | Data Type | Format | Mandatory | Length | Deskripsi | Example |
---|---|---|---|---|---|---|
responseCode | String | Numeric | M | 7 | Response code | 2002200 |
responseMessage | String | Alphanumeric | M | 150 | Description of response message |
Successful |
referenceNo | String | Numeric | O Note : SNAP BI (C) |
7 Note : Length SNAP BI (64) |
Unique reference number to be used when making the transfer | 7061005 |
externalId |
String | O | 12 |
External BRI ID to be used when making the transfer |
|
|
registrationId | String | O | Registrasion Id |
|
||
receiverName | String | O | Name of the recipient account holder |
|
||
beneficiaryAccountNo | String | Numeric | M | 34 | Destination account number for the transaction | 9876543210123456 |
beneficiaryBankCode | String | Alphanumeric | O | 8 | Bank code of the destination bank | CENAIDJA for Bank BCA |
accountNumber | String | O | Account number | |||
beneficiaryAccountType | String | O | Type of account number |
|
||
receiverType | String | O | 2 | Receiver type options
|
||
receiverIdentityNumber | String | O | Recipient identity number | |||
receiverResidentStatus | String | O | 2 | Receiver’s identity number: • 01=Resident • 02=NonResident |
||
receiverTownName | String | O | 4 |
Recipient city name |
0300 for Jakarta | |
currency | String | O | 3 |
Transaction currency |
IDR for the Indonesian Rupiah currency. |
|
additionalInfo | Object | C |
additionalInfo: Additional information input during the request, including:
|
Request & Response Payload Sample
Request
{ "partnerReferenceNo": "3287423894732", "beneficiaryBankCode": "CENAIDJA", "beneficiaryAccountNo": "2571075557", "additionalInfo": { "deviceId": "12345679237", "channel": "mobilephone" } }
Normal Response
{ "responseCode": "2008100", "responseMessage": "Successful", "referenceNo": "20241121BRINIDJA51050002841", "externalId": "52198916742", "receiverName": "BARXXXXXXXXXXXUMA", "beneficiaryAccountNo": "2571075557", "beneficiaryBankCode": "CENAIDJA", "beneficiaryAccountType": "SVGS", "receiverType": "02", "receiverResidentStatus": "01", "receiverTownName": "0300", "currency": "IDR", "additionalInfo": { "deviceId": "12345679237", "channel": "mobilephone" } }
Error Response :
{ "responseCode": "4008102", "responseMessage": "Invalid Mandatory Field beneficiaryAccountNo" }
List of Error/Response Code
HTTP Status |
Service Code |
Code |
Status |
Response Message |
Description |
---|---|---|---|---|---|
200 |
81 |
2008100 |
Success |
Successful |
|
400 |
81 |
4008101 |
Failed |
Invalid Field Format {fieldName} |
|
400 |
81 |
4008102 |
Failed |
Invalid Mandatory Field {fieldName} |
|
401 |
81 |
4018100 |
Failed |
Unauthoried. [Reason] |
|
404 |
81 |
4048100 |
Failed |
Invalid Transaction Status |
|
404 |
81 |
4048111 |
Failed |
Invalid Card/Account/Customer [info]/Virtual Account |
|
500 |
81 |
5008101 |
Suspend/Need To Check |
Internal Server Error |
|
500 |
81 |
5008100 |
Suspend/Need To Check |
General Error |
|
504 |
81 |
5048100 |
Suspend/Need To Check |
Timeout |