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