Cek Saldo

Cek Saldo Akun

Alamat Permintaan

GET /v1/balance

Autentikasi

Menggunakan Autentikasi Dasar HTTP. Tambahkan Authorization di Header HTTP:

Authorization: Basic ${base64_auth_string}

              
              Authorization: Basic ${base64_auth_string}

Tampilkan blok kode ini di jendela mengambang

base64_auth_string dihasilkan dengan: base64(dev_key:dev_secret)

Contoh Permintaan

Header Permintaan

GET /v1/balance HTTP/1.1 Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

              
              GET /v1/balance  HTTP/1.1
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

Tampilkan blok kode ini di jendela mengambang

Body Permintaan

Tidak ada

Parameter Permintaan

Tidak ada

Parameter Respons

Respons Berhasil

Field	Tipe	Opsi	Deskripsi
balance10000	Integer	Wajib	Saldo normal, nilai integer dikalikan 10000
gift_balance10000	Integer	Wajib	Saldo hadiah, nilai integer dikalikan 10000
balance	Number	Wajib	Saldo normal, floating-point
gift_balance	Number	Wajib	Saldo hadiah, floating-point
total_balance10000	Integer	Wajib	Saldo total, jumlah saldo normal dan saldo hadiah, nilai integer dikalikan 10000
total_balance	Number	Wajib	Saldo total, jumlah saldo normal dan saldo hadiah, floating-point

{ "balance10000": 123456, "gift_balance10000": 20000, "balance": 12.3456, "gift_balance": 2, "total_balance10000": 143456, "total_balance": 14.3456 }

              
              {
    "balance10000": 123456,
    "gift_balance10000": 20000,
    "balance": 12.3456,
    "gift_balance": 2,
    "total_balance10000": 143456,
    "total_balance": 14.3456
}

Tampilkan blok kode ini di jendela mengambang

Disarankan agar pemanggil memprioritaskan penggunaan field balance10000, gift_balance10000, dan total_balance10000 untuk memformat saldo sendiri, guna menghindari masalah presisi floating-point.

Respons Gagal

Kode status HTTP adalah 4xx atau 5xx, body respons berisi field berikut:

Field	Tipe	Opsi	Deskripsi
code	int	Wajib	Kode error, lihat Kode Error untuk detail
message	String	Wajib	Detail error

{ "code": 2001, "message": "invalid token" }

              
              {
    "code": 2001,
    "message": "invalid token"
}

Tampilkan blok kode ini di jendela mengambang

Kode Error

Kode Error	HTTP Code	Deskripsi
1000	500	Error internal, silakan coba lagi nanti
2001	401	Autentikasi gagal, token yang benar tidak disertakan, atau merchant yang sesuai dengan token tidak ada
2002	401	Autentikasi gagal, token telah kedaluwarsa atau telah dinonaktifkan
2002	403	Merchant telah dihapus