账户号码查询

/AccountProxyEnquiryRequest

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

信息

该 API 调用通过账户号码向 RPG 发送查询请求，以获取收款人的账户信息。 账户查询响应将发送回合作伙伴。合作伙伴应检查交易状态 txnSts 以确保请求没有错误。

请求参数

必填/有条件的字段

字段名称	类型	长度	描述	示例
txnType	字符串（数字）	3	交易类型。	"510" - 账户解析查询
sndrID	字符串	19	发送方标识。	"FNXSMYNX"
sndrIDType	字符串	1	发送方标识类型。	"0" – 主要帐户号码， "1" – 地方账号， "2" – 唯一参考号码 (URN), "3" – 商家ID (MID)
rcvrBIC	字符串	8	收款人 BIC。 附录 4	"RPPEMYKL"
sndrRefNo	字符串	35	发送方参考号。	"FNXS00000001"
sndrLocalTxnTime	字符串	14	本地交易时间。	"20220505103425"
sndrDeviceType	字符串	2	发送方设备类型。	"01" – 服务器, "02" – 移动设备, "03" – 自助服务亭
sndrDeviceVer	字符串	20	发送方应用程序版本号。	"1.0.35"
catPurp	字符串	4	条件性字段 类别目的。	"CASH" - 现金, "CCRD" - 信用卡, "LOAN" - 贷款
currCode	字符串	3	条件性字段 货币代码。	"MYR"
txnAmt	字符串（数字）	18,2	条件性字段 交易金额。	"1000.00"
cdtrAgtBIC	字符串	8	条件性字段 收款方代理 BIC。 附录 4	"PBBEMYKL"
cdtrAcct	字符串	34	条件性字段 收款方账号。	"73534278991"
cdtrAcctType	字符串	4	条件性字段 收款方账户所有权。	"CACC" - 活期账户, "SVGS" - 储蓄账户, "CCRD" - 信用卡, "LOAN" - 贷款账户, "DFLT" - 储蓄或活期账户
rcptRef	字符串	140	条件性字段 客户输入的收据参考。	"20201102REF0001"
duitNowIDType	字符串	4	条件性字段 DuitNow 身份类型。	"NRIC" - 身份证号码, "PSPT" - 护照号码, "BREG" - 商业注册号码, "MBNO" - 手机号码, "ARMN" - 军官证号码
duitNowID	字符串	140	条件性字段 DuitNow 身份。	"0127461835"
signature	字符串	999	消息的 Base64 格式签名。	"..."

可选字段

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

返回参数

必填/有条件的字段

字段名称	类型	长度	描述	示例
sndrRefNo	字符串	35	发件人参考号码。	"FNXS00000001"
lkUpRef	字符串	35	RPG 生成的唯一业务消息标识符。	"20201015FNXSMYNB610OOT01000001"
displNm	字符串	10	条件字段 收款人姓名。	"JOHN"
txnSts	字符串	4	交易状态。 附录 1	"ACSP", "ACTC", "RJCT", "OTHR"
rsn	字符串	7	交易状态原因。 附录 1
signature	字符串	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":"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":"..."
    }'

响应

Account Enquiry Response

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