付款转账

/DuitNowRequest

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

信息

这个 API 调用会发送付款转账的指令请求，可以是通过 DuitNow 或信用转账实现的。

• 信用转账 (txnType = 010)
• DuitNow 转账 (txnType = 110)

DuitNow 或信用转账的响应将发送回合作伙伴。合作伙伴需要检查交易状态 txnSts 以确保请求没有错误。

请求参数

强制字段

字段名	类型	长度	描述	示例
txnType	String (Numeric)	3	交易类型。	"010" - 信用转账, "110" - DuitNow 转账
sndrID	String	19	发送方身份识别。	"FNXSMYNX"
sndrIDType	String	1	发送方身份识别类型。	"0" – 主要账户号, "1" – 位置账户号, "2" – 唯一参考号 (URN), "3" – 商户 ID (MID)
rcvrBIC	String	8	收款方 BIC。 附录 4	"RPPEMYKL"
sndrRefNo	String	35	发送方参考号。	"FNXS00000002"
sndrLocalTxnTime	String	14	本地交易时间。	"20220505104518"
sndrDeviceType	String	2	发送方设备类型。	"01" – 服务器, "02" – 移动设备, "03" – 自助服务亭
sndrDeviceVer	String	20	发送方应用程序版本号。	"1.0.35"
catPurp	String	4	类别目的。	"CASH" - 现金, "CCRD" - 信用卡, "LOAN" - 贷款
currCode	String	3	货币代码。	"MYR"
txnAmt	String (Numeric)	18,2	交易金额。	"1000.00"
rcptRef	String	40	客户输入的收款方参考号。	"20201102REF0001"
lkUpRef	String	35	查找参考号。	"20201015FNXSMYNB610OOT01000001"
signature	String	999	消息的 Base64 格式签名。	"..."

可选字段

字段名	类型	长度	描述	示例
pymtDesc	String	140	其他付款描述。	"通过账户转账"
ipAddr	String	100	发件人 IP 地址。	"192.0.0.1"
emailAddr	String	100	收件人的电子邮件地址。	"rpg@gmail.com"
mobileNo	String	22	收件人的手机号码。	"0127461835"

返回参数

强制字段

字段名	类型	长度	描述	示例
sndrRefNo	String	35	发件人参考号。	"FNXS00000002"
bizMsgID	String	35	业务消息标识。	"20201015FNXSMYNB110OOT01000002"
txnSts	String	4	交易状态。 附录 1	"ACSP", "ACTC", "RJCT", "OTHR"
rsn	String	7	交易状态原因。 附录 1
snapshotBal	String (Numeric)	18,2	合作伙伴的商家账户余额。	"123456.00"
signature	String	999	签名。 附录 2	"..."

示例消息

请求

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":"..."
    }'

响应

Payment Transfer Response

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