BRIZZI
Introduction
API BRIZZI membuat Anda dapat mengisi ulang kartu BRIZZI. BRIZZI terdiri dari API dan SDK. Endpoint BRIZZI API digunakan untuk fungsi isi ulang. SDK BRIZZI digunakan untuk membaca dan menulis data pada kartu BRIZZI contohnya untuk pemeriksaan saldo kartu, riwayat transaksi kartu, dan pengecekan saldo kartu. SDK BRI hanya bekerja pada perangkat berbasis Android.
Validate Card Number
Endpoint ini digunakan untuk memvalidasi apakah nasabah menggunakan nomor kartu BRIZZI yang valid atau tidak saat melakukan isi ulang.
curl -X POST 'https://sandbox.partner.api.bri.co.id/v1/brizzi/topup/checknum' \
-H 'Authorization: Bearer {{TOKEN}}' \
-H 'BRI-Signature: {{SIGNATURE}}' \
-H 'BRI-Timestamp: {{TIMESTAMP}}' \
-H 'Content-Type: application/json' \
-d '{
"username": "ucon123",
"card_number": "5123456789012345"
}'
Contoh respon:
{
"status": {
"code": "00",
"desc": "SUCCESS"
}
}
HTTP Request
POST https://sandbox.partner.api.bri.co.id/v1/brizzi/topup/checknum
Request Body
Field | Data Type | Max Char | Mandatory | Description |
---|---|---|---|---|
username | String | - | Yes | Username used on third party application |
card_number | Numeric | 16 | Yes | Brizzi card number that will be topped up |
Response Body
Field | Data Type | Max Char | Mandatory | Description |
---|---|---|---|---|
status | ||||
code | String | 2 | Yes | Response status code |
desc | String | - | Yes | Response status description |
Top Up
Endpoint ini digunakan untuk mengisi ulang kartu BRIZZI. Saldo BRIZZI akan tersimpan dan diperbarui pada backend BRIZZI. Update saldo pada kartu dapat dilakukan menggunakan metode Update Pending Balance melalui SDK.
curl -X POST 'https://sandbox.partner.api.bri.co.id/v1/brizzi/topup' \
-H 'Authorization: Bearer {{TOKEN}}' \
-H 'BRI-Signature: {{SIGNATURE}}' \
-H 'BRI-Timestamp: {{TIMESTAMP}}' \
-H 'Content-Type: application/json' \
-d '{
"username": "ucon123",
"card_number": "5123456789012345",
"amount": "100000",
"reff_number": "100001"
}
Contoh respon:
{
"status": {
"code": "00",
"desc": "SUCCESS"
},
"brizzi": {
"amount": "100000",
"pending_balance": "150000",
"reff_number": "100001"
}
}
HTTP Request
POST https://sandbox.partner.api.bri.co.id/v1/brizzi/topup
Request Body
Field | Data Type | Max Char | Mandatory | Description |
---|---|---|---|---|
username | String | - | Yes | Username used on third party application (used for reconciliation) |
card_number | Numeric | 16 | Yes | Brizzi card number that will be topped up |
amount | Numeric | 7 | Yes | Top up amount |
reff_number | String | 30 | Yes | Reference number used for reconciliation |
Response Body
Field | Data Type | Max Char | Mandatory | Description |
---|---|---|---|---|
status | ||||
code | String | 2 | Yes | Response status code |
desc | String | - | Yes | Response status description |
brizzi | ||||
amount | Numeric | 7 | Yes | Top up amount |
pending_balance | Numeric | 7 | Yes | Pending balance stored in |
reff_number | String | 30 | Yes | Reference number used for reconciliation |
Check Top Up Status
Endpoint ini digunakan untuk memeriksa status isi ulang yang telah dilakukan. Biasanya endpoint ini digunakan ketika Anda melakukan permintaan isi ulang, namun Anda tidak mendapatkan respon apapun dari BRIAPI.
curl -X POST 'https://sandbox.partner.api.bri.co.id/v1/brizzi/topup/checktrx' \
-H 'Authorization: Bearer {{TOKEN}}' \
-H 'BRI-Signature: {{SIGNATURE}}' \
-H 'BRI-Timestamp: {{TIMESTAMP}}' \
-H 'Content-Type: application/json' \
-d '{
"username": "ucon123",
"card_number": "5123456789012345",
"amount": "100000",
"reff_number": "100001"
}
Contoh respon:
{
"status": {
"code": "00",
"desc": "SUCCESS"
},
"brizzi": {
"jenis_trx": "Top Up Pending"
}
}
HTTP Request
POST https://sandbox.partner.api.bri.co.id/v1/brizzi/topup/checktrx
Request Body
Field | Data Type | Max Char | Mandatory | Description |
---|---|---|---|---|
username | String | - | Yes | Username used on third party application (used for reconciliation) |
card_number | Numeric | 16 | Yes | Brizzi card number that will be topped up |
amount | Numeric | 7 | Yes | Top up amount |
reff_number | String | 30 | Yes | Reference number used for reconciliation |
Response Body
Field | Data Type | Max Char | Mandatory | Description |
---|---|---|---|---|
status | ||||
code | String | 2 | Yes | Response status code |
desc | String | - | Yes | Response status description |
brizzi | ||||
jenis_trx | String | - | Yes | Transaction type |
Error Codes
Code | Code Description |
---|---|
51 | Saldo Tidak Cukup |
53 | Rekening Tidak ditemukan |
54 | KARTU EXPIRED |
62 | KARTU TIDAK AKTIF |
93 | Duplicate Reff Number |
94 | Trx doesn't Exists |
99 | ERROR DLL |
NF | KARTU TIDAK TERDAFTAR |
NV | INVALID NUMERIC VALUE |
OT | MELEBIHI LIMIT TOPUP |
OV | MELEBIHI LIMIT KARTU |
Q1 | KONEKSI TERPUTUS |
Q4 | KONEKSI TIME OUT |