余额查询

/账户余额请求

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

备注

这个 API 调用允许合作伙伴向 RPG 发送账户余额查询请求。RPG 会回复合作伙伴提供账户余额信息。

请求参数

强制字段

字段名	类型	长度	描述	示例
sndrID	String	19	发件人身份识别码。	"FNXSMYNX"
sndrIDType	String	1	发件人身份识别类型。	"0" – 主要账户号码, "1" – 位置账户号码, "2" – 唯一参考号码 (URN), "3" – 商户ID (MID)
sndrRefNo	String	35	发件人参考号码。	"FNXS00000002"
orgnTxnRefNo	String	35	原始交易参考号码。	"FNXS202205050001"
sndrLocalTxnTime	String	14	本地交易时间。	"20220505104518"
sndrDeviceType	String	2	发件人设备类型。	"01" – 服务器, "02" – 移动设备, "03" – 自助服务亭
sndrDeviceVer	String	20	发件人应用程序版本号。	"1.0.35"
signature	String	999	Base64格式消息的签名。	"..."

返回参数

强制字段

字段名	类型	长度	描述	示例
sndrID	字符串	19	发送者身份标识	"FNXSMYNX"
sndrIDType	字符串	1	发送者身份标识类型	"0" - 主要账号编号， "1" - LOC 账号编号， "2" - 唯一参考编号 (URN)， "3" - 商户 ID (MID)
sndrRefNo	字符串	35	发送者参考编号	""
sndrLocalTxnTime	字符串	14	本地交易时间	"20220505104518"
sndrDeviceType	字符串	2	发送者设备类型	"01" - 服务器， "02" - 手机， "03" - 自助服务亭
sndrDeviceVer	字符串	20	发送者应用程序版本号	"1.0.35"
signature	字符串	999	Base64 格式的消息签名	"..."

备注

acctNo 和 snapshotBal 只会在 txnSts = "ACSP" 时返回。

示例消息

请求

Account Balance Enquiry Request

curl -X POST "https://xxx.finexusgroup.com/rpg/v1/AccountBalanceRequest" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 
 -d '{
        "message": {
            "sndrID":"FNXSMYNX",
            "sndrIDType":"2",
            "sndrRefNo":"",
            "sndrLocalTxnTime":"20220505104518",
            "sndrDeviceType":"01",
            "sndrDeviceVer":"1.0.35"
        }
        "signature":"..."
    }'

响应

Account Balance Enquiry Response

{
    "message": {
        "sndrRefNo":"FNXS00000002",
        "txnSts":"ACTC",
        "rsn":"",
        "cctNo":"112233445500",
        "snapshotBal":12345.00
    },
    "signature":"..."
}