DuitNow ID 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 DuitNow ID.
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
- Response Parameters
Mandatory / Conditional Fields
Field Name | Type | Length | Description | Example |
---|---|---|---|---|
txnType | String (Numeric) | 3 | Transaction type. | "610" - DuitNow ID 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" |
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
- Response
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":"610",
"sndrID":"FNXSMYNX",
"sndrIDType":"2",
"rcvrBIC":"RPPEMYKL",
"sndrRefNo":"FNXS00000001",
"sndrLocalTxnTime":"20220505103425",
"sndrDeviceType":"01",
"sndrDeviceVer":"1.0.35",
"pymtDesc":"Transfer via DuitNow",
"ipAddr":"192.0.0.1",
"duitNowIDType":"MBNO",
"duitNowID":"0127461835"
},
"signature":"..."
}'
Account Enquiry Response
{
"message": {
"sndrRefNo":"FNXS00000001",
"lkUpRef":"20201015FNXSMYNB610OOT01000001",
"displNm":"JOHN",
"txnSts":"ACTC",
"rsn":""
},
"signature":"..."
}