充值

简要描述

用于为卡片充值余额。

变更记录

日期	内容	详细说明
2025-06-30	最低充值限额	实体卡最低限额200，虚拟卡最低限额20

请求URL

${baseUrl}/api/card/top/up

请求方式

方法：POST
Content-Type: application/json

请求参数

参数名	必选	类型	说明
merOrderNo	是	string	渠道订单号
cardNumber	是	string	卡号/账户
amount	是	string	金额（最多支持两位小数，直接截取；不同卡片增值不同货币）
notifyUrl	否	string	订单通知地址，不为空时处理完成后通知此地址
ext	否	string	预留字段，处理特殊业务

返回示例

{
    "data": {
        "cardNumber": "6244810070000117",
        "completeTime": "",
        "createTime": "2023-04-02 17:07:09",
        "ext": "",
        "merOrderNo": "345342352343",
        "orderNo": "4534234363464342",
        "settleAmount": "20.00",
        "status": 0
    },
    "msg": "操作成功",
    "status": 200,
    "success": true
}

返回参数说明

响应字段

参数名	示例	说明	备注
data	见下表	响应数据，订单信息	object
msg	操作成功	响应消息	string
status	200	响应码	int
success	true	是否成功（true/false）	bool

data - 订单信息

参数名	示例	说明
merOrderNo	436343534234	渠道订单号
cardNumber	6244810070000117	卡号
orderNo	35432346345345	平台订单号
settleAmount	20.00	结算金额，最多两位小数，若大于2位小数则舍去（如2.123则为2.12）
status	1	订单状态：1-处理中，2-成功，3-失败
createTime	2023-04-02 17:07:09	订单创建时间
completeTime	2023-04-02 17:07:09	订单完成时间
ext		订单额外信息，预留字段

业务状态码说明

状态码	描述
200	成功
500	失败（需要查询订单确认）
5000	操作异常（需查询订单确认）
5101	请勿重复下单
5102	备用金余额不足

Keyboard shortcuts

api