# 4. 代扣查询接口
# 说明
- 商户代扣交易查询接口
# 请求URL
/api/jt/direct/debit/query
# 请求方式
- POST
# 请求头
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | application/json |
# 请求体参数
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 应用APPID |
| timestamp | 是 | long | 当前时间戳（毫秒） |
| transactionId | 是 | string | 交易流水号 |
| sign | 是 | string | 签名，参考签名算法 |
# 请求体示例
{
"appId": "123456",
"timestamp": 1672531200000,
"transactionId": "TXN20240101120000123456",
"sign": "EJeMHGDlLu3DdbIK/52aID1soLrD0rfGcEEsAQ8cXFWaXQHioVwfZUD82U5g67NTXP/F/0Mhg6bK7n6rJlC/clYzqZ1kHmO2FbCdujw0ATY+FfM6VkgVT4pXr1jYmg3Xe23RDqhFvkDcOfRvaGPtnf64yrQG32MZps23TsbnafitDbtfqSoDIZkDCw1j1EH3Shhd64xKh9L3O8ivyF2UDOiHSAD8+18JXOxMWMFcR01STKE5B+zlEu5OA98+ClDBdroekBVKDeBeagwwQr+0zDFUvAb+2QIPKA2o0JM3ooituiaKVCgCVfndNjk8wIzKz2QYp+RhjVOC/u+8+Yoqb4KoWjGkMXgDbM1GZpdHG/BmzqXqhnNF0Y0LYS4bkITstlOm30nnHSljT5bxjk2Sq1hp9259SqMdp52OyoznxbRwEva5Wk5YPo+zD8IHOctEjkwWXz9/jo2evK6QcWCOH2LM6cG7EoP6Cg+5P2AUTofSMZsn/ZnAy6h9MXIuirDBiujrKMk85EY74s8i7yCNmjQ5NRbPbKsNTJbkxp2cRSMPzYPzOXXqEgKMmYzVQ5SSAcqFZIj2fAOL/3fG+2aEMn/8AFjJuD3/160BmYCZbAY4A2LJow6SGP/OcifvWPwoziJv0IP5Jff59w0mv6h0+3HnJg5YAcqK7dani1C0cAQ="
}
# 响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | integer | 响应码 |
| message | string | 响应信息 |
| data | Object | 数据 |
# data参数
| 字段名 | 类型 | 说明 |
|---|---|---|
| mchOrderId | string | 商户订单号 |
| transactionId | string | PayCools 唯一交易流水号 |
| amount | long | 交易金额（单位：分） |
| transactionStatus | string | 交易状态 |
| createTime | string | 创建时间 |
| returnTime | string | 返回/回调时间 |
| appName | string | 应用名称 |
| customerName | string | 客户姓名 |
| channelCode | string | 渠道代码 |
| string | 客户邮箱 | |
| mobile | string | 客户手机号 |
| remark | string | 备注 |
| callbackUrl | string | 回调URL |
# 响应示例
{
"code": 10000,
"message": "Success",
"data": {
"mchOrderId": "DD20240101120000",
"transactionId": "TXN20240101120000123456",
"amount": 10000,
"transactionStatus": "SUCCESS",
"createTime": "2024-01-01 12:00:00",
"returnTime": "2024-01-01 12:01:30",
"customerName": "John Doe",
"channelCode": "JTWALLET_DIRECT_DEBIT",
"email": "johndoe@example.com",
"mobile": "09123456789",
"remark": "Monthly subscription payment",
"callbackUrl": "https://merchant.com/notify/direct-debit"
}
}
# 响应失败案例 响应code列表
{
"code": 1002,
"message": "merchant white ip forbidden"
}