Balance Inquiry

Digunakan untuk melihat saldo user

note

untuk pengecekan akun id master hanya perlu token B2B

Service Info

HTTP Method	POST
Service Code	11
Http Method	POST
Path	.../{version}/balance-inquiry

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
Authorization	String	Y	Token B2B
Authorization-Customer	String	Y	Token B2B2C
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token B2B2C: Signature Generation
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	String	Y	Nomor referensi yang harus unik pada hari yg sama
CHANNEL-ID	String	Y	00001 untuk PJP and 00002 untuk non PJP

Body

Parameter	Tipe Data	Wajib	Deskripsi
additionalInfo	Object	Y	Informasi tamabahn
merchantId	String	Y	Kode unik yang dimiliki setiap user Length: <= 64 characters

Request samples

JSON

{
  "additionalInfo": {
    "merchantId": "121xxxx",
  }
}

CURL

curl --location --request POST '.../v1.0/balance-inquiry' \
--header 'X-TIMESTAMP: 2023-01-19T09:31:00+07:00' \
--header 'X-SIGNATURE: RwABEherf+3MTBhIf6vtju6ko+YOFFKWLGgHCD5RwX1I17JCKVn8ffc/TenEIly85InhuIcKCDqDrxbIBhaKEg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: 61fbe9da-4661-46df-a44c-8275d869ca8b' \
--header 'X-DEVICE-ID: android-20013adf6cdd8123f' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Authorization-Customer: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Content-Type: application/json' \
--data '{
    "additionalInfo": {
        "merchantId": "121xxxx"
    }
}'

Response Structure

Parameter	Tipe Data	Deskripsi
responseCode	String	Response Code Length: <= 7 karakter
responseMessage	String	Response Description Length: <= 150 karakter
accountNo	String	Response Description Lenght: <= 32 karakter
name	String	Nama pemilik akun
availableBalance	Object	Saldo yang tersedia
value	String	Jumlah saldo yang dapat digunakan untuk transaksi keuangan
currency	String	Mata uang

Response samples

{
  "responseCode": "2001100,",
  "responseMessage": "Successful,",
  "accountNo": "62812xxxxxxxx",
  "name": "Madara Uchiha",
  "availableBalance": {
    "value": "75000.00",
    "currency": "IDR"
  }
}

List Response Code Balance Inquiry

Response Code	Response Message	Description
2001100	Success	Sukses
4001101	Invalid field format { field name }	Format invalid
4001102	Invalid mandatory field {field name}	Format pada bidang wajib tidak ada atau tidak valid
4011100	Unauthorized. Invalid Signature	X-Signature salah
4091100	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4041101	Bad Request	Request header ada yang salah / kurang
4041101	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait