BRIZZI
API Information
Title | BRIZZI |
---|---|
Version |
v1.0 |
URL Sandbox |
https://sandbox.partner.api.bri.co.id/v1/brizzi/topup |
URL Production |
https://partner.api.bri.co.id/v1/brizzi/topup |
Version Control
Doc Version |
API Version |
Date |
Link to document |
Description |
---|---|---|---|---|
v1.0 |
v1.0 |
1 February 2019 |
This Page |
Initial version |
Product Description
The BRIZZI API allows you to top up your BRIZZI card. BRIZZI consists of API and SDK. The BRIZZI API endpoint is used to reload your card. The BRIZZI SDK is used to read and write data on BRIZZI cards, for example, check card balances and view transaction history. The BRI SDK only works on Android-based devices.
Flow API
A. Validate Card Number
Endpoint Description
This endpoint is used to validate whether the customer uses a valid BRIZZI card number or not when they top up their cards
curl --location --request POST 'https://sandbox.partner.api.bri.co.id/v1/brizzi/topup/checknum' \
--header 'Content-Type: application/json' \
--header 'BRI-Signature: {{SIGNATURE}} \
--header 'BRI-Timestamp: {{TIMESTAMP}}' \
--header 'Authorization: Bearer {{TOKEN}}' \
--data-raw '{
"username": "TitoPamungkas",
"card_number": "6013500111614641"
}'
Response Example :
{
"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 |
B. Top Up
Endpoint Description
This endpoint is used to recharge the BRIZZI card. The BRIZZI balance will be saved and updated on the BRIZZI backend. Updating the balance on the card can be done using the Update Pending Balance method via the SDK.
curl --location --request POST 'https://sandbox.partner.api.bri.co.id/v1/brizzi/topup' \
--header 'BRI-Signature: {{SIGNATURE}}' \
--header 'BRI-Timestamp: {{TIMESTAMP}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{TOKEN}}' \
--data-raw '{
"username":"TitoPamungkas",
"card_number":"6013500111614641",
"amount":"1000",
"reff_number":"123762"
}'
Response Example :
{
"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 |
C. Check Top Up Status
Endpoint Description
This endpoint is used to check the card reload status. Normally, this endpoint will be used when you have a request to reload balances, but you don’t get a response from BRIAPI.
curl --location --request POST 'https://sandbox.partner.api.bri.co.id/v1/brizzi/topup/checktrx' \
--header 'Content-Type: application/json' \
--header 'BRI-Signature: {{SIGNATURE}}' \
--header 'BRI-Timestamp: {{TIMESTAMP}}' \
--header 'Authorization: Bearer {{TOKEN}}' \
--data-raw '{
"reff_number": "123762",
"amount": "1000",
"card_number": "6013500111614641",
"username": "TitoPamungkas"
}'
Response Example :
{
"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 | Not enough balance |
53 | Account Not found |
54 | EXPIRED CARD |
62 | CARD NOT ACTIVE |
84 | ERROR DLL |
93 | Duplicate Reff Number |
94 | Trx doesn't Exists |
99 | ERROR DLL |
NF | NOT REGISTERED CARD |
NV | INVALID NUMERIC VALUE |
OT | OVER THE TOPUP LIMIT |
OV | OVER THE LIMIT CARD |
Q1 | DISCONNECTED CONNECTION |
Q4 | TIME OUT CONNECTION |