Merchant Balance Inquiry

This API is used to get the current balance of a registered merchant.

Technical Specification

Environment	Method	URL
Development	POST	https://snapstag.finnet.co.id/topup/v1.0/balance-inquiry-merchant

Required Headers

No	Name	Type	Mandatory	Description
1	Content-Type	String	M	Fill with application/json
2	Authorization	String	M	Bearer <access_token>
3	X-TIMESTAMP	String	M	Timestamp in RFC3339 format: yyyy-MM-ddTHH:mm:ssTZD
4	X-PARTNERID	String (36)	M	Client ID provided by Finnet
5	X-SIGNATURE	String	C	BI SNAP symmetric signature. Use base64(HMAC_SHA512($ClientSecret, stringToSign)). See Signature for details.
6	X-EXTERNAL-ID	String (36)	M	Reference number that must be unique within the same day
7	X-CHANNEL-ID	String (5)	M	PJP’s channel id Device identification on which the API services is currently being accessed by the end user (customer)

Body Request

No	Name	Type	Mandatory	Description
1	partnerReferenceNo	String (64)	M	Transaction identifier on service consumer system

Sample Request

curl --location ' https://snapstag.finnet.co.id/topup/v1.0/balance-inquiry-merchant' \ 
 --header 'Authorization: Basic ZGVtby51c2VyOg==' \ 
 --header 'Content-Type: application/json' \ 
 --header 'Accept: application/json' \ 
 --data '{ 
   "partnerReferenceNo": "TRX001" 
 }' 

Body Response

No	Name	Type	Mandatory	Description
1	responseCode	Enum	M	BI SNAP Response Code.
2	responseMessage	String	M	BI SNAP Response Message.
3	referenceNo	String (8)	C	Transaction identifier on service provider system
4	partnerReferenceNo	String (64)	C	Transaction identifier on service consumer system
5	name	String	M	Merchant name
6	accountInfos	Object	M	Detail of Account Info

Sample Response

{
  "responseCode": "2001100",
  "responseMessage": "Request has been processed successfully",
  "referenceNo":"20201029",
  "partnerReferenceNo":"2020102900000000000001",
  "name": "Testing Nandhief",
  "accountInfos": [
    {
      "availableBalance": {
        "value": "0.00",
        "currency": "IDR"
      }
    }
  ]
}

Response Code & Message

The table below lists response codes and messages for the Merchant Balance Inquiry API.

No	HTTP Code	Code	Message
1	200	2001100	Successful
2	400	4001100	Bad request
3	400	4001101	Invalid field format {field}
4	400	4001102	Invalid mandatory field {field}
5	401	4011101	Invalid token (B2B)
6	401	4011100	Unauthorised. [Reason]
7	403	4031101	Feature not allowed
8	403	4031104	Activity count limit exceeded
9	404	4041108	Invalid merchant
10	500	5001100	General error
11	504	5041100	Timeout