2. 查询授权状态接口

简要描述

• 授权代扣-查询授权状态接口

HTTP请求信息

请求URL

• {domain}/open-api/direct/debit/token/query

请求方式

• POST

请求头

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

请求体参数

参数名	必选	类型	说明
appId	是	string	应用APPID
param	是	string	参数体
sign	是	string	签名

param 参数

参数名	必选	类型	长度限制	示例	说明
userID	是	string	1-32	-	商户内部用户ID
payToken	否	string	-	-	token值
timestamp	是	long			当前时间戳

请求体示例

{
  "appId":"b96f05030ffc411185c06f959e1c9210",
  "sign":"hu79rII/VwshksImrt5KHAHt8u+3qY4y+E/iAlYSYTRm3WYih+aLVV1Rmdm99b+MfYnkvSDgHjTDpUTSy2o4Q5QWyOJBC2BLoJv+ndjdysiGgHditCYgohY08FBEhgWtAX5GJG+rut9UxXnGeIob0tdemc2vJODaVJ4BZ0+iq7xQEl2MltiLpYBZnjvIsJoTYmyFwXeZ8zx+8iJ3nXHXwzspugXIlT0MiEouH0y+02RYOOmCZRmc1CgCywliS+3R+g/xLOK0m9tDGlXXg29NH4amJGqxQTFGzbDPLgrhrWbHsIBqfDDjRRGQrCufS3ZX3TuOGhOTPNKvBY8DTD/54A==",
  "param":"{\"userId\":\"u0009\",\"timestamp\":1726137892}"
}

如何构造请求体

---

响应参数

参数名	类型	说明
code	integer	响应码
message	string	响应信息
data	Object	数据

data参数

参数名	类型	示例	说明
userId	String	商户内部用户ID
tokenList	List<TokenInfo>	token详情列表

TokenInfo参数

参数名	类型	说明
channelcode	string	渠道码
paytoken	string	token值
tokenStatus	string	token状态 (ACTIVED, INACTIVED)
expiresTime	string	token过期时间
inactiveTime	string	token失效时间
inactiveType	string	token失效类型 (MCH_CANCEL, PLATFORM_CANCEL, USER_CANCEL, EXPIRED)

返回示例

响应参数

{
  "code": 10000,
  "message": "Success",
  "data": {
    "userId": "u00012",
    "tokenList": [
      {
        "channelCode": "BLUEPAY_DIRECT_DEBIT",
        "payToken": "TK1U2ODY9EPKRSOSU9",
        "tokenStatus": "INACTIVED",
        "expiresTime": "2034-09-18 18:10:35",
        "inactiveTime": "2024-09-18 18:14:15",
        "inactiveType": "MCH_CANCEL"
      },
      {
        "channelCode": "BLUEPAY_DIRECT_DEBIT",
        "payToken": "TKJ7F0DY9GD4JN1ATD",
        "tokenStatus": "INACTIVED",
        "expiresTime": "2034-09-18 18:29:08",
        "inactiveTime": "2024-09-18 18:30:28",
        "inactiveType": "MCH_CANCEL"
      },
      {
        "channelCode": "BLUEPAY_DIRECT_DEBIT",
        "payToken": "TKJ2F4DY9HWLMPJKLD",
        "tokenStatus": "ACTIVED",
        "expiresTime": "2034-09-18 18:46:24"
      }
    ]
  }
}

响应码集合

失败返回示例

{
    "code": 21010,
    "message": "transaction not found",
    "data": null
}