2. 获取钱包用户信息(余额)

请求URL

• {domain}/open-api/jt/wallet/balance

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	是	string	application/json

请求体参数

参数名	必选	类型	说明
appId	是	string	Application APPID
param	是	string	Parameter body
sign	是	string	Signature

param 参数

参数名	必选	类型	长度	示例	说明
timestamp	是	long	-	1677495496979	毫秒时间戳
mchUuidList	否	List	5000	-	商户用户uuid唯一标识号
size	否	int	-	-	每页显示条数(不传默认为15条,单页最大条数10000)
page	否	int	-	-	页数(不传默认为第1页)
KYCStatus	否	List	-	-	用户信息审核状态(Unsubmitted, Pending, Approved, Rejected)
authorizationStatus	否	List	-	-	用户授权代扣状态(Authorized,Unauthorized)
mobileVerificationStatus	否	List	-	-	用户手机号校验状态(Verified,Unverified)
userStatus	否	List	-	-	用户状态(Active,Deactivating,Deactivated)

请求示例

请求体

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"timestamp\":1715595802,\"mchUuidList\":[\"JT1095595801938341100\",\"JT1095595801938341101\"]}"
}

How to construct request body

---

响应参数

参数名	类型	说明
code	integer	response code
message	string	response message
data	Object	data

data参数

参数名	类型	说明
list	List	分页记录信息,按记录的创建时间倒序
total	integer	总条数
size	integer	每页显示条数
current	integer	当前页
totalBalance	long	总钱包余额 (单位为分 如:500泰铢 示例:50000)
totalBaseBalance	lEcpay Collection Reference.mdong	总普通余额 (单位为分 如:500泰铢 示例:50000)
totalWithdrawThreshold	long	总留存金额/信誉额度 (单位为分 如:500泰铢 示例:50000)

list参数

参数名	类型	说明
mchUuid	string	商户用户uuid唯一标识号
uuid	string	钱包用户uuid
balance	long	钱包余额 (单位为分 如:500泰铢 示例:50000)
baseBalance	long	普通余额 (单位为分 如:500泰铢 示例:50000)
withdrawThreshold	long	留存金额/信誉额度 (单位为分 如:500泰铢 示例:50000)
createTime	string	"2024-11-22 00:00:00"
updateTime	string	"2024-11-22 00:00:00"
KYCStatus	string	用户信息审核状态(Unsubmitted, Pending, Approved, Rejected)
authorizationStatus	string	用户授权代扣状态(Authorized,Unauthorized)
mobileVerificationStatus	string	用户手机号校验状态(Verified,Unverified)
userStatus	string	用户状态(Active,Deactivating,Deactivated)

响应示例

响应数据体

{
  "code": 10000,
  "message": "Success",
  "data": {
    "total": 2,
    "size": 15,
    "current": 1,
    "totalBalance": 0,
    "totalBaseBalance": 0,
    "totalCodBalance": 0,
    "totalUnclearBillAmountDue": 334044,
    "totalUnclearBillAmount": 334044,
    "totalWithdrawThreshold": 159500,
    "list": [
      {
        "mchUuid": "JT1095595801938341100",
        "uuid": "U1095595801938341100",
        "centerNo": "A000001",
        "branchNo": "A000001",
        "balance": 360000,
        "baseBalance": 200000,
        "codBalance": 160000,
        "withdrawThreshold": 20000,
        "unclearBillAmountDue": 50000,
        "unclearBillAmount": 60000,
        "createTime": "2024-11-22 00:00:00",
        "updateTime": "2024-11-22 00:00:00",
        "KYCStatus": "Pending",
        "authorizationStatus": "Authorized",
        "mobileVerificationStatus": "Verified",
        "codEnableStatus": "Enable",
        "userStatus": "Active"
      },
      {
        "mchUuid": "JT1095595801938341101",
        "uuid": "U1095595801938341100",
        "centerNo": "A000001",
        "branchNo": "A000001",
        "balance": 360000,
        "baseBalance": 200000,
        "codBalance": 160000,
        "withdrawThreshold": 20000,
        "unclearBillAmountDue": 50000,
        "unclearBillAmount": 60000,
        "createTime": "2024-11-22 00:00:00",
        "updateTime": "2024-11-22 00:00:00",
        "KYCStatus": "Pending",
        "authorizationStatus": "Authorized",
        "mobileVerificationStatus": "Verified",
        "codEnableStatus": "Enable",
        "userStatus": "Active"
      }
    ]
  }
}

Code Collection

失败响应示例

{
  "code": 1002,
  "message": "merchant white ip forbidden"
}