Account Number Enquiry

/AccountProxyEnquiryRequest

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

info

This API call sends an enquiry request to RPG to enquire the recipient account information via account number. Account enquiry response will be sending back to the partner. Partner shall check the transaction status txnSts to ensure no error on the request.

Request Parameters

Mandatory / Conditional Fields

Field Name	Type	Length	Description	Example
txnType	String (Numeric)	3	Transaction type.	"510" - Account resolution enquiry
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)
rcvrBIC	String	8	Beneficiary BIC. Appendix 4	"RPPEMYKL"
sndrRefNo	String	35	Sender reference number.	"FNXS00000001"
sndrLocalTxnTime	String	14	Local transaction time.	"20220505103425"
sndrDeviceType	String	2	Sender device type.	"01" – Server, "02" – Mobile, "03" – Self-service Kiosk
sndrDeviceVer	String	20	Sender application version number.	"1.0.35"
catPurp	String	4	Conditional field Category purpose.	"CASH" - Cash, "CCRD" - Credit Card, "LOAN" - Loan
currCode	String	3	Conditional field Currency code.	"MYR"
txnAmt	String (Numeric)	18,2	Conditional field Transaction amount.	"1000.00"
cdtrAgtBIC	String	8	Conditional field Creditor/receiver agent BIC. Appendix 4	"PBBEMYKL"
cdtrAcct	String	34	Conditional field Creditor/receiver account number.	"73534278991"
cdtrAcctType	String	4	Conditional field Creditor/receiver account proprietary.	"CACC" - Current Account, "SVGS" - Savings Account, "CCRD" - Credit Card, "LOAN" - Loan Account, "DFLT" - Either Savings or Current Account
rcptRef	String	140	Conditional field Recipient reference entered by customer.	"20201102REF0001"
duitNowIDType	String	4	Conditional field DuitNow identification type.	"NRIC" - NRIC Number, "PSPT" - Passport Number, "BREG" - Business Registration Number, "MBNO" - Mobile Number, "ARMN" - Army Number
duitNowID	String	140	Conditional field DuitNow identification.	"0127461835"
signature	String	999	Signature of the message in Base64 format.	"..."

Optional Fields

Field Name	Type	Length	Description	Example
pymtDesc	String	140	Other payment description.	"Transfer via account"
ipAddr	String	100	Sender IP Address.	"192.0.0.1"

Response Parameters

Mandatory / Conditional Fields

Field Name	Type	Length	Description	Example
sndrRefNo	String	35	Sender reference number.	"FNXS00000001"
lkUpRef	String	35	A unique Business Message Identification generates by RPG.	"20201015FNXSMYNB610OOT01000001"
displNm	String	10	Conditional field Beneficiary name.	"JOHN"
txnSts	String	4	Transaction status. Appendix 1	"ACSP", "ACTC", "RJCT", "OTHR"
rsn	String	7	Transaction status reason. Appendix 1
signature	String	999	Signature. Appendix 2	"..."

note

lkUpRef and dispNm will only return when the txnSts is either "ACSP" or "ACTC".

Example Message

Request

Account Enquiry Request

curl -X POST "https://xxx.finexusgroup.com/rpg/v1/AccountProxyEnquiryRequest" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 
 -d '{
        "message": { 
            "txnType":"510",
            "sndrID":"FNXSMYNX",
            "sndrIDType":"2",
            "rcvrBIC":"RPPEMYKL",
            "sndrRefNo":"FNXS00000001",
            "sndrLocalTxnTime":"20220505104518",
            "sndrDeviceType":"01",
            "sndrDeviceVer":"1.0.35",
            "catPurp":"CASH",
            "currCode":"MYR",
            "txnAmt":1000.00,
            "cdtrAgtBIC":"PBBEMYKL",
            "cdtrAcct":"73534278991",
            "cdtrAcctType":"SVGS",
            "rcptRef":"20201102REF0001",
            "pymtDesc":"Transfer via account",
            "ipAddr":"192.0.0.1"
        },
        "signature":"..."
    }'

Response

Account Enquiry Response

{
    "message": { 
        "sndrRefNo":"FNXS00000001",
        "lkUpRef":"20201015FNXSMYNB610OOT01000001",
        "displNm":"JOHN",
        "txnSts":"ACTC",
        "rsn":""
    },
    "signature":"..."
}