查询转账状态

1、查询转账状态

接口路径

• Get
• /api/wallet/check

请求参数

参数	名称	类型	必填	说明
agent_id	商户ID	string	必填	商户ID
user_id	商户侧用户ID	string	必填	商户侧用户ID
type	交易类型	string	必填	deposit: 转入， withdraw: 转出
txn_id	转账交易ID	string	必填	转入/转出交易ID
timestamp	当前时间戳	int	必填	传调用接口时的时间戳（单位毫秒，有效期十分钟）
sign	签名	string	必填	签名算法详见接口说明

响应参数

参数	名称	类型	说明
code	响应码	int	错误码
message	响应信息	string	错误信息
data	响应数据	dict	响应数据详情
--agent_id	商户ID	string	商户ID
--user_id	商户侧用户ID	string	商户侧用户ID
--txn_id	转账交易ID	string	转账交易ID
--before_balance	转账前会员余额	string	转账前会员余额
--after_balance	转账后会员余额	string	转账后会员余额
--currency	币种	string	币种
--status	订单状态	int	订单状态，0-进行中，1-成功，2-失败

请求范例

curl --location 'https://staging.aig1234.com/api/wallet/check?agent_id=agent001&user_id=testUid03&type=deposit&txn_id=txniwsdfa342&timestamp=1732589849000&sign=8f1374b31c83ff1b60e2062897851b84' \
--header 'Content-Type: application/json'

响应范例

{
    "code": 200,
    "message": "success",
    "data": {
        "agent_id": "agent001",
        "user_id": "testUid03",
        "txn_id": "txniwsdfa342",
        "before_balance": "-0.69",
        "after_balance": "1000.00",
        "currency": "VND2",
        "status": 1
    }
}

错误码

200 成功
408000 请求参数错误
408003 白名单限制
408004 API频率限制
600100 签名不合法
700101 商户不存在
700103 会员不存在
700201 会员钱包不存在
700202 会员钱包类型不是转账钱包
700205 交易ID不存在