Fund Transfer Internal v3.1

Unduh Postman

Gambaran Produk

API ini memungkinkan partner untuk melakukan transfer dana antara dua rekening BRI (transfer internal). Rekening sumber adalah rekening milik partner. API transfer dana ini hanya bisa dilakukan untuk rekening giro dan rekening tabungan.

Endpoint

Penjelasan Endpoint

Layanan ini digunakan untuk melakukan inquiry informasi rekening Debet dan Kredit yang akan digunakan untuk melakukan instruksi Fund Transfer. Rekening yang dapat di inquiry adalah rekening giro dan simpanan yang sudah terdaftar sebelumnya.

Informasi Umum

Header Structure

Request Structure

Response Structure

Request & Response Payload Sample

Request :

curl --location --request POST 'https://sandbox.partner.api.bri.co.id/v3.1/transfer/internal/accounts' \
--header 'BRI-Timestamp: ((TIMESTAMP))' \
--header 'BRI-Signature: ((SIGNATURE))' \
--header 'Content-Type: application/json' \
--data-raw '{
"sourceAccount": "020601000255504",
"beneficiaryAccount": "0206010060313061"
}'

Normal Response :

{
    "responseCode": "0100",
    "responseDescription": "Inquiry success",
    "errorDescription": "",
    "data": {
        "sourceAccount": "020601000255504",
        "sourceAccountName": "Jane Doe",
        "sourceAccountStatus": "Rekening Aktif",
        "sourceAccountBalance": "8631682596.05",
        "beneficiaryAccount": "020601006031306",
        "beneficiaryAccountName": "John Doe",
        "beneficiaryAccountStatus": "Rekening Aktif"
    }
}

Error Response :

{
    "responseCode": "0101",
    "responseDescription": "Inquiry failed",
    "errorDescription": "InqRekAsal: Nomor Rekening Tidak Dikenal & InqRekTujuan: 0000020601006031306",
    "data": {
        "sourceAccount": "020601023500255504",
        "beneficiaryAccount": "020601006031306"
    }
}

List of Error/Response Code

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

Notes: Silahkan lihat juga halaman "Common Errors" untuk daftar kesalahan umum di BRIAPI

Penjelasan Endpoint

Endpoint ini digunakan untuk melakukan permintaan transfer dana antara dua rekening BRI. Ada limit total total transaksi dan limit transaksi harian yang akan ditetapkan oleh BRI.

Informasi Umum

Header Structure

Request Structure

Response Structure

Request & Response Payload Sample

Request :

curl --location --request POST 'https://sandbox.partner.api.bri.co.id/v3.1/transfer/internal' \
  --header 'BRI-Timestamp: ((TIMESTAMP))' \
  --header 'BRI-Signature: ((SIGNATURE))' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "noReferral": "20210202126111111111",
    "sourceAccount": "020601000255504",
    "beneficiaryAccount": "020601006031306",
    "amount": "10000.00",
    "feeType": "OUR",
    "transactionDateTime": "09-03-2021 15:08:00",
    "remark": "REMARK TEST"
  }'	

Normal Response :

{
  "responseCode": "0200",
  "responseDescription": "Payment Success",
  "errorDescription": "",
  "journalSeq": "8020001"
}

Error Response:

{
  "responseCode": "0299",
  "responseDescription": "Payment Failed",
  "errorDescription": "Reference number is not valid"
}

List of Error/Response Code

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

Notes: Silahkan lihat juga halaman "Common Errors" untuk daftar kesalahan umum di BRIAPI.

Catatan: Layanan pengecekan status hanya dapat dilakukan di luar periode Akhir Hari (EOD). Untuk setiap transaksi transfer yang dilakukan pada periode EOD yang menghasilkan time-out atau respons tertunda, pengecekan akun dapat dilakukan pada pukul 8 pagi Waktu Indonesia Barat.

Penjelasan Endpoint

Endpoint ini digunakan untuk mengecek status dari transaksi yang telah dilakukan. Gunakan ini jika ketika melakukan transaksi tidak mendapatkan response atau error yang jelas, seperti: time out. Untuk diperhatikan bahwa response dari endpoint ini tidak menggambarkan status akhir dari proses transfer. Setelah mendapatkan 'internalTransferStatus" dan "internalTransferErrorMessage" di body response, silahkan lihat daftar error code di endpoint Transfer, untuk mengidentifikasi apakah transaksi Anda sukses, gagal, atau Pending. Sebagai alternatif yang lebih valid, partner bisa menggunakan endpoint Check Status Rekening Koran.

Informasi Umum

Header Structure 

Request Structure

Response Structure

Request & Response Payload Sample

Request :

curl -X POST 'https://sandbox.partner.api.bri.co.id/v3.1/transfer/internal/check' \
 -H 'Authorization: Bearer {{TOKEN}}' \ -H 'X-BRI-Signature: {{SIGNATURE}}' \ -H 'BRI-Timestamp: {{TIMESTAMP}}' \ -H 'Content-Type: application/json' \ -d '{ "noReferral": "20180212002" }'

Normal Response :

{ "responseCode":"0300", "responseDescription":"Cek Status Sukses", "errorDescription":"", "data": { "noReferral":"20210202126111111111" "journalSeq":"8020001", "internalTransferStatus":"0200", "internalTransferErrorMessage":"", } }

Error Response:

{ "responseCode":"0307", "responseDescription":"Reference number not found",
 "errorDescription":"", "data":{} }

List of Error/Response Code

notes : Layanan check status rekening koran untuk saat ini hanya tersedia di luar periode jam EOD (End Of Day). Untuk transaksi transfer yang dilakukan di jam EOD kemudian mendapatkan timeout / Pending, pengecekan status dapat dilakukan mulai jam 08.00 WIB.

Penjelasan Endpoint

Endpoint ini digunakan untuk mengetahui status transaksi pemindahbukuan (transfer) antar rekening BRI yang dilakukan sebelumnya berdasarkan hasil pengecekan ke rekening koran. Pengecekan dapat dilakukan setelah 15 menit dari waktu transaksi.

Informasi Umum

Header Structure 

Request Structure

Response Structure

Request & Response Payload Sample

Request :

 curl --location --request POST ''\''https://sandbox.partner.api.bri.co.id/v3.1/transfer/internal/check-rekening' \
  --header 'BRI-Timestamp: ((TIMESTAMP))' \
  --header 'BRI-Signature: ((SIGNATURE))' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "noReferral": "ABCD2021033112369",
  "transactionDate": "01-04-2021"
  }'

Normal Response :

{
	"responseCode": "0300",
	"responseDescription": "Status check success",
	"data": {
		"noReferral": "ABCD2021033112345",
		"journalSeq": "7021301",
		"amount": "10000.00",
		"remark": "REMARK TEST BRIAPI",
		"internalTransferStatus": "0200",
		"internalTransferDescription": "Payment success"
	}
}

Error Response:

{
  "responseCode": "0212",
  "responseDescription": "Request can not be processed",
  "errorDescription": "Invalid format transaction datetime",
  "data": {}
}	

List of Transfer Status

Gunakan parameter ini untuk menentukan apakah transaksi yang dilakukan sukses atau gagal

List of Error/Response Code

Sebagai syarat utama partner agar bisa menggunakan environment production API Transfer Internal, partner wajib melakukan proses rekonsiliasi menggunakan API Riwayat Transaksi atau menggunakan file mt940 yang disediakan pada H+1. Cara penggunaan dan pengajuan mt940 dapat dilihat pada halaman berikut [Link]. 

Partner juga harus melihat common error BRIAPI yang berlaku untuk seluruh produk BRIAPI, dan melakukan penanganan error sesuai dengan deskripsi yang dicantumkan.