DuitNow ID 查询

/AccountProxyEnquiryRequest

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

信息

这个 API 调用发送了一个查询请求到 RPG，通过 DuitNow ID 查询接收者的账户信息。 账户查询的响应将会发送回合作伙伴。合作伙伴需要检查交易状态 txnSts，确保请求没有错误。

请求参数

必填/有条件的字段

字段名	类型	长度	描述	示例
txnType	String (Numeric)	3	交易类型。	"610"
sndrID	String	19	发件人标识。	"FNXSMYNX"
sndrIDType	String	1	发件人标识类型。	"0"
rcvrBIC	String	8	受益方 BIC。	"RPPEMYKL"
sndrRefNo	String	35	发件人参考编号。	"FNXS00000001"
sndrLocalTxnTime	String	14	本地交易时间。	"20220505103425"
sndrDeviceType	String	2	发件人设备类型。	"01"
sndrDeviceVer	String	20	发件人应用程序版本号。	"1.0.35"
catPurp	String	4	条件性字段 类别目的。	"CASH"
currCode	String	3	条件性字段 货币代码。	"MYR"
txnAmt	String (Numeric)	18,2	条件性字段 交易金额。	"1000.00"
cdtrAgtBIC	String	8	条件性字段 收款方代理 BIC。	"PBBEMYKL"
cdtrAcct	String	34	条件性字段 收款方账户号码。	"73534278991"
cdtrAcctType	String	4	条件性字段 收款方账户所有权。	"CACC"
rcptRef	String	140	条件性字段 客户输入的收款方参考。	"20201102REF0001"
duitNowIDType	String	4	条件性字段 DuitNow 身份类型。	"NRIC"
duitNowID	String	140	条件性字段 DuitNow 身份。	"0127461835"
signature	String	999	Base64 格式的消息签名。	"..."

可选字段

字段名称	类型	长度	描述	示例
pymtDesc	字符串	140	其他付款描述。	"通过帐户转账"
ipAddr	字符串	100	发件人 IP 地址。	"192.0.0.1"

返回参数

必填/有条件的字段

字段名	类型	长度	描述	示例
sndrRefNo	String	35	发件人参考编号。	"FNXS00000001"
lkUpRef	String	35	RPG 生成的唯一业务消息标识。	"20201015FNXSMYNB610OOT01000001"
displNm	String	10	条件性字段 受益人姓名。	"JOHN"
txnSts	String	4	交易状态。 附录 1	"ACSP", "ACTC", "RJCT", "OTHR"
rsn	String	7	交易状态原因。 附录 1
signature	String	999	签名。 附录 2	"..."

备注

lkUpRef 和 dispNm 仅在 txnSts 为 "ACSP" 或 "ACTC" 时返回。

示例消息

请求

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