SKNBI Transfer 

Informasi API

Title

API Transfer SKNBI

Version

v1.0

URL Sandbox

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

URL Production

 

Kendali Versi

Versi API

Tanggal

Link Dokumen

Deskripsi

v1.0

26 November 2021

Halaman ini.

Baseline version

v2.0

12 April 2022

Halaman ini.

Update Field Format

Deskripsi Produk

Gambaran Produk

Fitur ini digunakan untuk melakukan pemindahbukuan dana dari satu rekening Non-PJP Pengguna Layanan, PJP PIAS, atau PJP AIS Lembaga Selain Bank, pada PJP AIS Bank ke rekening tujuan pada PJP AIS Bank lain melalui perantaraan Penyelenggara Infrastruktur Pembayaran (PIP) BI-RTGS.

Endpoint

A. API Trigger Transfer / SKNBI Transfer

General Information

HTTP Method

POST

Path

/snap/v1.0/transfer-sknbi

Tipe Format

JSON

Authentication

OAuth 2.0 with Access Token

Header Structure Request

Key

Value

Format

Mandatory

Length

Deskripsi

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

 

Alphanum eric

M

36

 

CHANNEL-ID

 

Alphanum eric

M

5

 

X-EXTERNAL-ID

 

Numeric

M

36

 

Request Structure

Field

Data Type

Format

Mandatory

Length

Deskripsi

Contoh

partnerReference No

String

Alphanum eric

M

64

Identifikasi transaksi pada sistem layanan konsumen

20201029000

000000002

amount

Object

 

M

     

>value

String

Decimal

M

15,2

Note : Length SNAP BI

(16,2)

Jumlah bersih dari transaksi. Jika itu IDR maka nilainya termasuk 2 angka desimal, contoh RP 10.000, akan ditempatkan dengan 10000.00

110000000.00

>currency

String

Alphanum eric

M

3

Mata uang transaksi

IDR

beneficiaryAccou ntName

String

Alphanum eric

M

100

Nama rekening penerima

Yories Yolanda

beneficiaryAccou ntNo

String

Numeric

M

34

Rekening penerima

88880100015

7508

beneficiaryAddre ss

String

Alphanum eric

M

Note: SNAP BI (O)

100

Alamat penerima

Palembang

beneficiaryBankC ode

String

Alphanum eric

M

8

Kode Bank penerima

CENAIDJA

beneficiaryCusto merResidence

String

Alphanum eric

M

1

Status Kewarganegaraan penerima :

1.Indonesia

2. Non Indonesia

1

beneficiaryCusto merType

String

Numeric

M

1

Jenis nasabah penerima :

  1. Perorangan

  2. Perusahaan

  3. Pemerintah

1

customerReferen ce

String

Alphanum eric

M

20

Note : Length SNAP BI (30)

Nomor referensi / No Referral / Transaksi ID

100520193

feeType

String

Alphanum eric

M

Note : SNAP BI (O)

25

Jenis penanggung biaya (BEN=biaya ditanggung penerima, OUR=ditanggung pengirim, SHA=sharing)

BEN

receiverPhone

String

Numeric

O

20

Nomor hp/telepon penerima

091234567890

remark

String

Alphanum eric

M

40

Note : Length SNAP BI (50)

Keterangan/deskripsi transaksi

remark test

senderCustomer Residence

String

Numeric

M

Note : SNAP BI (O)

1

Status kewarganegaraan pengirim :

  1. Indonesia

  2. Non Indonesia

1

senderCustomer Type

String

Numeric

M

Note : SNAP BI (O)

1

Jenis nasabah pengirim :

  1. Perorangan

  2. Perusahaan

  3. Pemerintah

1

senderPhone

String

Numeric

O

20

Sumber telepon pelanggan

080901020304

sourceAccountNo

String

Numeric

M

15

Note : Length SNAP BI (19)

Kode Bank penerima

88880100015

7509

transactionDate

String

Datetime

M

25

Tanggal transaksi : dd-MM-yyyy (Mandatory) HH:mm:ss (Optional)

2021-12-

30T10:38:00-

07:00

additionalInfo

Object

 

M

Note : SNAP BI (O)

 

Informasi tambahan

 

>deviceId

String

Alphanum eric

O

   

12345679237

>channel

String

Alphanum eric

O

   

mobilephone

>senderName

String

Alphanum eric

M

100

Nama Pengirim

Latifah Hanum

>senderIdentity

String

Numeric

M

16

Nomor identitas (NIK KTP) pengirim

31520510019

0093

>senderAddress

String

Alphanum eric

M

150

Alamat Pengirim

Jakarta Selatan

>corporateType

String

Numeric

M

1

Jenis badan usaha yang bisa digunakan, meliputi :

  1. konvensional

  2. syariah

1

Response Structure & Sample

Field

Data Type

Format

Mandatory

Length

Deskripsi

Contoh

responseCode

String

Numeric

M

7

Kode respon

2002300

responseMes sage

String

Alphanum eric

M

150

Respon deskripsi

Successful

referenceNo

String

Numeric

O

Note : SNAP BI (C)

7

Note : Length SNAP BI (64)

Identifikasi transaksi pada sistem penyedia layanan. Harus diisi setelah transaksi berhasil

59924966539

7303382689

amount

Object

 

O

 

 

 

>value

String

Decimal

M

15,2

Note : Length SNAP BI

(16,2)

Jumlah bersih dari transaksi. Jika itu IDR maka nilainya termasuk 2 angka desimal, contoh RP 10.000, akan ditempatkan dengan 10000.00

110000000.00

>currency

String

Alphanum eric

M

3

Mata uang transaksi

IDR

beneficiaryAc countName

String

Alphanum eric

M

100

Nama rekening penerima

Yories Yolanda

beneficiaryAc countNo

String

Numeric

M

34

Nomor rekening penerima

88880100015

7508

beneficiaryBa nkCode

String

Alphanum eric

O

8

Kode Bank penerima

CENAIDJA

customerRefe rence

String

Alphanum eric

M

20

Nomer referensi / No Referral / Transaksi ID

100520193

sourceAccoun tNo

String

Numeric

M

15

Note : Length SNAP BI (19)

Nomor rekening pengirim

88880100015

7509

transactionDate

String

Datetime

M

25

Tanggal transaksi : dd-MM-yyyy (Mandatory) HH:mm:ss (Optional)

2021-12-

30T10:38:00-

07:00

transactionSta tus

String

Numeric

M

2

00- Success

01- Initiated

03 - Pending

06 - Failed

06

transactionSta tusDesc

String

Alphanum eric

O

50

Deskripsi status transaksi

Failed

additionalInfo

Object

 

M

Note :

SNAP BI

(O)

 

Informasi tambahan

Additional Information

>deviceId

String

Alphanum eric

O

 

 

12345679237

>channel

String

Alphanum eric

O

 

 

mobilephone

Request & Response Payload Sample

Request 

	
    {
        "partnerReferenceNo": "20201029000000000002",
        "amount": {
            "value": "110000000.00",
            "currency": "IDR"
        },
        "beneficiaryAccountName": "Yories Yolanda",
        "beneficiaryAccountNo": "888801000157508",
        "beneficiaryAddress": "Palembang",
        "beneficiaryBankCode": "CENAIDJA",
        "beneficiaryCustomerResidence": "1",
        "beneficiaryCustomerType": "1",
        "customerReference": "100520193",
        "feeType": "BEN",
        "receiverPhone": "091234567890",
        "remark": "remark test",
        "senderCustomerResidence": "1",
        "senderCustomerType": "1",
        "senderPhone": "080901020304",
        "sourceAccountNo": "888801000157509",
        "transactionDate": "2021-12-30T10:38:00-07:00",
        "additionalInfo": {
            "deviceId": "12345679237",
            "channel": "mobilephone",
            "senderName": "Latifah Hanum",
            "senderIdentity": "315205100190093",
            "senderAddress": "Jakarta Selatan",
            "corporateType": "1"
        }
    }'                                                 

Normal Response :

	{
        "responseCode": "2002300",
        "responseMessage": "Successful",
        "referenceNo": "3599249665397303382689",
        "amount": {
            "value": "110000000.00",
            "currency": "IDR"
        },
        "beneficiaryAccountName": "Yories Yolanda",
        "beneficiaryAccountNo": "888801000157508",
        "beneficiaryBankCode": "CENAIDJA",
        "customerReference": "100520193",
        "sourceAccountNo": "888801000157509",
        "transactionDate": "2021-12-30T10:38:00-07:00",
        "transactionStatus": "06",
        "transactionStatusDesc": "Failed",
        "additionalInfo": {
            "deviceId": "12345679237",
            "channel": "mobilephone"
        }
    }                 

Error Response :

	{
        "responseCode": "4002302",
        "responseMessage": "Invalid Mandatory Field partnerReferenceNo"
    }                                               

List of Error/Response Code

HTTP Status

Service Code

Case Code

Status

Response Message

Deskripsi

200

23

00

Sukses

Successful

Sukses

400

23

01

Gagal

Invalid format

Format tidak valid

400

23

02

Gagal

invalid mandatory field

Format field mandatory tidak valid atau hilang

403

23

02

Gagal

Exceeds Transaction Amount Limit

 

403

23

09

Gagal

Dormant Account

 

403

23

14

Gagal

Insufficient Funds

 

403

23

15

Gagal

Transaction Not Permitted

 

403

23

16

Pending

Suspend Transaction

 

403

23

18

Gagal

Inactive Account

 

404

23

11

Gagal

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

 

404

23

13

Gagal

Invalid Amount

 

409

23

00

Gagal

Conflict

Tidak boleh menggunakan X-EXTERNAL-ID yang sudah digunakan

500

23

01

Pending

Unknown Error

 

500

23

00

Pending

General Erorr

 

504

23

00

Pending

Timeout