跳到主要内容

账户信息查询

POST /v1/mid-open-api/account/query
需要验证签名

接口描述

查询账户的相关信息

请求头

ParameterTypeRequiredDescription
AuthorizationstringMaccess_token
Content-TypestringMapplication/json

请求参数

ParameterTypeRequiredDescription
client_idstringM客户在PINGPONG注册后的唯一ID
account_typestringO账户类型, 见附录
currencystringO账户币种
extra_infostringO其他的信息,json

返回响应

无账户时返回 null

ParameterTypeDescription
client_idstring客户在PINGPONG注册后的唯一ID
account_info_listarray账户列表

account_info_list

ParameterTypeDescription
account_typestring账户类型, 见附录
avail_balancenumber可用余额
frozen_balancenumber冻结余额
currencystring账户币种
account_statusstring账户状态, 见附录

返回示例

{
"code": 200,
"data": {
"client_id": "abc00001",
"account_info_list": [
{
"account_type": "AVAIL_ACCOUNT",
"avail_balance": 10.00,
"frozen_balance": 0.00,
"currency": "USD",
"account_status": "NORMAL"
},
{
"account_type": "TEMP_ACCOUNT",
"avail_balance": 0.00,
"frozen_balance": 0.00,
"currency": "USD",
"account_status": "NORMAL"
}
]
},
"message": "SUCCESS"
}

错误码

返回码描述解决方案
900000system error系统错误,请联系PingPong技术人员核查
900002illegal param参数有误,请根据提示更正信息

附录

account_type (账户类型)

含义
AVAIL_ACCOUNT可用账户
TEMP_ACCOUNT资金暂存户;用于存储资金流已到账,但还未风控审核通过的资金;审核通过后会转入可用账户

account_status (账户状态)

含义
NORMAL正常
ABNORMAL异常;当内部审查有风险、或其他需要的情况,会将账户置为异常;异常状态下的账户禁止交易
CLOSED注销