Payment Transfer

/DuitNowRequest

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

info

This API call sends request for instruction of the payment transfer via DuitNow or Credit Transfer.

• Credit Transfer ( txnType = 010 )
• DuitNow Transfer ( txnType = 110 )

DuitNow or Credit Transfer 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 Fields

Field Name	Type	Length	Description	Example
txnType	String (Numeric)	3	Transaction type.	"010" - Credit Transfer, "110" - DuitNow Transfer
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.	"FNXS00000002"
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"
catPurp	String	4	Category purpose.	"CASH" - Cash, "CCRD" - Credit Card, "LOAN" - Loan
currCode	String	3	Currency code.	"MYR"
txnAmt	String (Numeric)	18,2	Transaction amount.	"1000.00"
rcptRef	String	40	Recipient reference entered by customer.	"20201102REF0001"
lkUpRef	String	35	Look up reference.	"20201015FNXSMYNB610OOT01000001"
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"
emailAddr	String	100	Recipient's email address.	"rpg@gmail.com"
mobileNo	String	22	Recipient's mobile number.	"0127461835"

Response Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
sndrRefNo	String	35	Sender reference number.	"FNXS00000002"
bizMsgID	String	35	Business message identification.	"20201015FNXSMYNB110OOT01000002"
txnSts	String	4	Transaction status. Appendix 1	"ACSP", "ACTC", "RJCT", "OTHR"
rsn	String	7	Transaction status reason. Appendix 1
snapshotBal	String (Numeric)	18,2	Partner’s merchant business account balance.	"123456.00"
signature	String	999	Signature. Appendix 2	"..."

Example Message

Request

Payment Transfer Request

curl -X POST "https://xxx.finexusgroup.com/rpg/v1/DuitNowRequest" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 
 -d '{
         "message": { 
            "txnType":"010",
            "sndrID":"FNXSMYNX",
            "sndrIDType":"2",
            "rcvrBIC":"RPPEMYKL",
            "sndrRefNo":"FNXS00000002",
            "sndrLocalTxnTime":"20220505104518",
            "sndrDeviceType":"01",
            "sndrDeviceVer":"1.0.35",
            "catPurp":"CASH",
            "currCode":"MYR",
            "txnAmt":1000.00,
            "rcptRef":"20201102REF0001",
            "pymtDesc":"Transfer via account",
            "ipAddr":"192.0.0.1",
            "lkUpRef":"20201015FNXSMYNB610OOT01000001",
            "emailAddr":"rpg@gmail.com",
            "mobileNo":"0127461835"            
        },
        "signature":"..."
    }'

Response

Payment Transfer Response

{
    "message": { 
        "sndrRefNo":"FNXS00000002",
        "bizMsgID":"20201015FNXSMYNB110OOT01000002",
        "txnSts":"ACTC",
        "rsn":"",
        "snapshotBal":123456.00
    },
    "signature":"..."
}