Account Balance Enquiry

/AccountBalanceRequest

Method : POST
URL : https://xxx.finexusgroup.com/rpg/v1/AccountBalanceRequest

info

This API call enables Partner to send an Account Balance enquiry request to RPG. RPG responds to Partner with the account balance information.

Request Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
sndrID	String	19	Sender identification.	"FNXSMYNX"
sndrIDType	String	1	Sender identification type.	"0" – Primary Account Number, "1" – LOC Account Number, "2" – Unique Reference Number (URN), "3" – Merchant ID (MID)
sndrRefNo	String	35	Sender reference number.	""
sndrLocalTxnTime	String	14	Local transaction time.	"20220505104518"
sndrDeviceType	String	2	Sender device type.	"01" – Server, "02" – Mobile, "03" – Self-service Kiosk
sndrDeviceVer	String	20	Sender application version number.	"1.0.35"
signature	String	999	Signature of the message in Base64 format.	"..."

Response Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
sndrRefNo	String	35	Sender reference number.	"FNXS00000002"
txnSts	String	4	Transaction status. Appendix 1	"ACSP", "ACTC", "RJCT", "OTHR"
rsn	String	7	Transaction status reason. Appendix 1
acctNo	String	50	Conditional field Partner’s business account number.	"112233445500"
snapshotBal	String (Numeric)	18,2	Conditional field Partner’s merchant business account balance.	"12345.00"
signature	String	999	Signature. Appendix 2	"..."

note

acctNo and snapshotBal will only return when the txnSts = "ACSP".

Example Message

Request

Account Balance Enquiry Request

curl -X POST "https://xxx.finexusgroup.com/rpg/v1/AccountBalanceRequest" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 
 -d '{
        "message": {
            "sndrID":"FNXSMYNX",
            "sndrIDType":"2",
            "sndrRefNo":"",
            "sndrLocalTxnTime":"20220505104518",
            "sndrDeviceType":"01",
            "sndrDeviceVer":"1.0.35"
        }
        "signature":"..."
    }'

Response

Account Balance Enquiry Response

{
    "message": {
        "sndrRefNo":"FNXS00000002",
        "txnSts":"ACTC",
        "rsn":"",
        "cctNo":"112233445500",
        "snapshotBal":12345.00
    },
    "signature":"..."
}