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