查询卡余额

简要描述

查询卡余额

请求URL

/open/merchant/api/findUserCardBalance

测试环境域名：https://sbx-card-api.alchemypay.org
正式环境域名：https://card-api.alchemypay.org

请求方式

POST

Content-Type: application/json

参数

参数名	验签	必选	类型	长度	说明
cardId	是	是	string	64	卡id
appId	是	是	String	32	商户appid
sign	否	是	string	512	签名

请求参数示例

JSON

{
  "cardId": "c_590c6c4cc0f6471b979b",
  "appId": "qmamnbodyqzbdr0w",
  "sign": "8979EEB59CF15246A04E033962CA4084973A9D0F2F5CC08F07B99E9D0338F4486ED7700CF78F6365C2E399ED593B3EF9059F2EC808B5107CED8CC17BA0475962"
}

返回参数说明

参数名	类型	说明
code	string	编码 详情看code描述
msg	string	返回信息
model	object	成功时返回
└ currency	string	币种
└ balance	double	卡余额
└ topUpBalance	double	可充值金额
traceId	string	无
success	boolean	成功状态
error	boolean	失败状态

成功返回示例

JSON

{
    "code":"0",
    "msg":"成功",
    "model":{
        "currency":"EUR",
        "balance":100.01,
        "topUpBalance":9989.99
    },
    "traceId":"64461f5414909b4b1e05a58fd7e818d1",
    "error":false,
    "success":true
}

失败返回示例

JSON

{
  "code": "1002",
  "msg": "User card information does not exist c_590c6c4cc0f6471b979b ",
  "model": null,
  "traceId": "6566f01975d31fa30b55fb9a2a5c5516",
  "error": true,
  "success": false
}

备注

更多返回错误代码请看code描述