Tarik Tunai Tanpa Kartu

Apa itu Tarik Tunai Tanpa Kartu?

Pertumbuhan transaksi digital di Indonesia yang begitu pesat mendorong BRI untuk berinovasi dalam memberikan kenyamanan bertransaksi kepada masyarakat. Peningkatan penggunaan aplikasi keuangan mobile menjadi salah satu faktor perubahan perilaku masyarakat dalam memenuhi kehidupan transaksi sehari-hari. Dengan kondisi tersebut, BRI menghadirkan fitur tarik tunai tanpa kartu di mesin ATM dan CRM BRI yang bisa dilakukan oleh nasabah BRI maupun partner bisnis BRI. Partner bisnis yang telah bekerja sama dengan BRI dapat memanfaatkan layanan ini untuk mempermudah penggunanya untuk melakukan penarikan uang tunai melalui ATM/CRM BRI. Pengguna layanan dari Partner Bisnis BRI dapat memasukkan nomor virtual account yang di tampilkan pada aplikasi Partner Bisnis kemudian digunakan untuk akses fitur tarik tunai tanpa kartu yang tersedia di ATM/CRM BRI. Dengan layanan ini, pengguna dari aplikasi Partner Bisnis tersebut dapat dengan nyaman melakukan tarik tunai saldo wallet secara tunai di ATM BRI seluruh Indonesia.

Informasi API

Judul

Tarik Tunai Tanpa Kartu

Versi

v1.1

URL Sandbox

Disediakan oleh Partner

URL Production

 

Kendali Versi

Versi Dok

Versi API

Tanggal

Tautan dokumen

Deskripsi

v1.0

v1.0

11 Oktober 2021

Halaman ini.

Versi awal

v1.1 v1.1 9 September 2022 Halaman ini
  • Penambahan optional parameter "atmLocation" pada request endpoint Cardless Withdrawal
  • Perubahan parameter "amount" dan "trxDate" menjadi optional pada request endpoint Cardless Reversal

 

Deskripsi Produk

Gambaran Umum Produk

Pertumbuhan transaksi digital di Indonesia yang begitu pesat mendorong BRI untuk berinovasi dalam memberikan kenyamanan bertransaksi kepada masyarakat. Peningkatan penggunaan aplikasi keuangan mobile menjadi salah satu faktor perubahan perilaku masyarakat dalam memenuhi kehidupan transaksi sehari-hari. Dengan kondisi tersebut, BRI menghadirkan fitur tarik tunai tanpa kartu di mesin ATM dan CRM BRI yang bisa dilakukan oleh nasabah BRI maupun partner bisnis BRI.

Partner bisnis yang telah bekerja sama dengan BRI dapat memanfaatkan layanan ini untuk mempermudah penggunanya untuk melakukan penarikan uang tunai melalui ATM/CRM BRI. Pengguna layanan dari Partner Bisnis BRI dapat memasukkan nomor virtual account yang di tampilkan pada aplikasi Partner Bisnis kemudian digunakan untuk akses fitur tarik tunai tanpa kartu yang tersedia di ATM/CRM BRI. Dengan layanan ini, pengguna dari aplikasi Partner Bisnis tersebut dapat dengan nyaman melakukan tarik tunai saldo wallet secara tunai di ATM BRI seluruh Indonesia.

API Tarik Tunai Tanpa Kartu merupakan produk API yang disediakan oleh BRI dan pihak ketiga (partner bisnis BRI) yang memungkinkan nasabah pihak ketiga dapat melakukan tarik tunai tanpa kartu di ATM BRI melalui aplikasi pihak ketiga.

Pihak ketiga dapat membuat API berdasarkan spesifikasi berikut pada sistem pihak ketiga sehingga BRI dapat melakukan pemanggilan API.

flow tarik tunai tanpa kartu

Endpoint

A. Auth Token

Deskripsi Endpoint

API Cardless Withdrawal Get Token untuk mendapatkan token Oauth2.0 guna melakukan pembuatan signature.

Informasi Umum

HTTP Method

POST

Path

http://{base_url_partner}/v1/cardless/token

Tipe Format

JSON

Authentication

-

Struktur Header

Key

Value

Mandatory

Panjang

Deskripsi

Contoh

Content-Type

application/json

M

-

-

-

Struktur Request 

Field

Tipe Data

Mandatory

Panjang

Deskripsi

Contoh

providerId

String

M

-

   

secretKey

String

M

-

   

Struktur Respon

Field

Tipe Data

Mandatory

Panjang

Deskripsi

Contoh

accessToken

String

M

-

 

-

responseCode

String

M

-

   

responseMessage

String

M

-

   

expiredIn

String

M

-

Masa berlaku token  dalam hitungan detik

 

Contoh Payload Request dan Respon

Request :

{
   "providerId":"QwErTy123",
   "secretKey":"PoIuY098"
}

Respon Normal :

{
   "responseKode":"00",
   "responseMessage":"success",
   "accessToken":"
   lfbo1985ujlnbviovQOUB12oifnfiqIO",
   "expiredIn":"180"
}                                    

Respon Error :

{
   "responseKode":"01",
   "responseMessage":"Invalid providerId or secretKey"
}                                                                                                           

Daftar Error/Kode Respon

HTTP Status

Kode

Status

Deskripsi Respon 

Deskripsi

200

00

Sukses

Success

Sukses jika mendapatkan RC 00, selain itu gagal

400

01

Gagal

Invalid providerId or secretKey

Transaksi Gagal

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

B. Cardless Withdrawal

Deskripsi Endpoint

API Cardless Withdrawal merupakan API yang digunakan untuk melakukan update data ke pihak ke-3 untuk proses tarik tunai di ATM.

Informasi Umum

HTTP Method

POST

Path

http://{base_url_partner}/v1/cardless/withdrawal

Tipe Format

JSON

Autentikasi

Bearer Token

Struktur Header

Key

Nilai

Mandatory

Panjang

Deskripsi

Contoh

signature

signature

M

-

Signature

https://developers.bri.co.id/docs/dokumentasi#signature

 

timestamp

ISO 8601

 

-

   

Content-Type

application/json

M

-

-

-

Struktur Request

Field

Tipe Data

Mandatory

Panjang

Deskripsi

Contoh

token

String

M

9

Kode OTP

 

msisdn

String

M

18

Nomor Virtual Account

 

merchantTrxID

String

M

25

Merchant transaction ID

 
atmLocation String O   Lokasi ATM  

Struktur Respon

Field

Tipe Data

Mandatory

Panjang

Deskripsi

Contoh

responseKode

String

M

2

Kode Respon

-

responseMessage

String

M

50

Deskripsi Respon

 

msisdn

String

M

18

Nomor virtual account

 

amount

String

M

22

Nominal transaksi

 

trxDate

String

M

23

Tanggal transaksi

(format: yyyy-MM-dd HH:mm:ss.fff)

 

merchantTrxID

String

M

25

Merchant transaction ID, unik untuk setiap transaksi

 

linkRefNum

String

M

25

Nomor referensi

 

 

Request :

{
   "token":"9203310116",
   "msisdn":"8118821681",
   "merchantTrxID":"1000000007",
   "atmLocation":"KCK. 0206-CRM Hitachi"
}

Respon Normal :

{
   "responseKode":"00",
   "responseMessage":"success",
   "msisdn":"8118821681",
   "amount":"50000.00",
   "trxDate":"2019-10-14 15:20:40.043",
   "merchantTrxID":"0000000007",
   "linkRefNum":"5GP7L02UR75GP7L02UR7"
}                                           

Respon Error:

{
   "responseKode":"02",
   "responseMessage":"Invalid PartnerId"
}                                                                                                                  

Daftar Error / Kode Respon

HTTP Status

Kode

Status

Deskripsi Respon

Deskripsi

200

00

Sukses

success

Sukses jika mendapatkan RC 00, selain itu gagal

400

02

Gagal

Invalid PartnerId

Transaksi Gagal

400

12

Gagal

Invalid Request/Unauthorized/Invalid Signature

Transaksi Gagal

400

14

Gagal

Virtual Account Not Found

Transaksi Gagal

400

16

Gagal

Token Expired

Transaksi Gagal

400

18

Gagal

Insufficient Balance

Transaksi Gagal

400

20

Gagal

Duplicate Transaction Id

Transaksi Gagal

400

68

Gagal

Timeout

Transaksi Gagal

400 99 Gagal Undefined Error Transaksi Gagal
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan

C. Cardless Reversal

Deskripsi Endpoint

API Cardless Reversal merupakan API yang digunakan untuk melakukan reversal ke pihak ke-3 jika terjadi kegagalan saat proses tarik tunai.

Informasi Umum

HTTP Method

POST

Path

http://{base_url_partner}/v1/cardless/reversal

Tipe Format

JSON

Autentikasi

Bearer Token

Struktur Header

Key

Nilai

Mandatory

Panjang

Deskripsi

Contoh

signature

signature

M

-

Signature

https://developers.bri.co.id/docs/dokumentasi#signature

 

timestamp

ISO 8601

 

-

   

Content-Type

application/json

M

-

-

-

Struktur Request

Field

Tipe Data

Mandatory

Panjang

Deskripsi

Contoh

token

String

M

9

Kode OTP

 

msisdn

String

M

18

Nomor Virtual Account

 

merchantTrxID

String

M

25

Merchant transaction ID

 

amount

String

O

22

Nominal transaksi

 

trxDate

String

O

23

Tanggal transaksi

(Format: yyyy-MM-dd HH:mm:ss.fff)

 

Struktur Respon

Field

Tipe Data

Mandatory

Panjang

Deskripsi

Contoh

responseKode

String

M

2

Response Kode

-

responseMessage

String

M

50

Response message

 

msisdn

String

M

18

Nomor virtual account

 

amount

String

M

22

Nominal transaksi

 

trxDate

String

M

23

Tanggal transaksi

(format: yyyy-MM-dd HH:mm:ss.fff)

 

merchantTrxID

String

M

25

Merchant transaction ID, unik untuk setiap transaksi

 

Contoh Payload Request & Respon

Request :

{
   "token":"999995678",
   "amount":"10000.00",
   "msisdn":"0816789012",
   "merchantTrxID":"000777",
   "trxDate":"2019-10-14 15:20:40.043"
}

Respon Normal :

{
   "responseKode":"00",
   "responseMessage":"success",
   "amount":"10000.00",
   "msisdn":"0816789012",
   "merchantTrxID":"000777",
   "trxDate":"2019-10-16 15:20:40.043"
}                                               

Error Response :

{
   "responseKode":"02",
   "responseMessage":"Invalid PartnerId"
}                                                                                                                  

Daftar Error / Kode Respon

HTTP Status

Kode

Status

Response Deskripsi

Deskripsi

200

00

Sukses

success

Sukses jika mendapatkan RC 00, selain itu gagal

400

02

Gagal

Invalid PartnerId

Reversal Gagal

400

12

Gagal

Invalid Request/Unauthorized/Invalid Signature

Reversal Gagal

400

14

Gagal

Virtual Account Not Found

Reversal Gagal

400

22

Gagal

Original Transaction Id not Found

Reversal Gagal

400

68

Gagal

Timeout

Reversal Gagal

400 99 Gagal Undefined Error Reversal Gagal
Seluruh response error yang tidak tercantum dalam list response BRIAPI memiliki status pending dan perlu dilakukan pengecekan