4. Direct Debit Pay Query

Description

• Merchant direct debit transaction query interface

Request URL

• /api/jt/direct/debit/query

Request Method

• POST

Request Headers

Parameter Name	Required	Type	Description
Content-Type	Yes	string	application/json

Request Body Parameters

Field	Required	Type	Description
appId	Yes	string	Application APPID
timestamp	Yes	long	Current timestamp (milliseconds)
transactionId	Yes	string	Transaction serial number
sign	Yes	string	Signature, refer to Signature Algorithm

Request Body Example

{
  "transactionId": "TXN20240101120000123456"
}

Response Parameters

Parameter Name	Type	Description
code	integer	Response code
message	string	Response message
data	Object	Data

data Parameters

Field Name	Type	Description
mchOrderId	string	Merchant order number
transactionId	string	PayCools unique transaction serial number
amount	integer	Transaction amount (unit: cents)
transactionStatus	string	Transaction status
createTime	string	Creation time
returnTime	string	Return/callback time
appName	string	Application name
customerName	string	Customer name
channelCode	string	Channel code
email	string	Customer email
mobile	string	Customer mobile number
remark	string	Remark
callbackUrl	string	Callback URL

Response Example

{
  "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",
    "appName": "Merchant App",
    "customerName": "John Doe",
    "channelCode": "JTWALLET_DIRECT_DEBIT",
    "email": "johndoe@example.com",
    "mobile": "09123456789",
    "remark": "Monthly subscription payment",
    "callbackUrl": "https://merchant.com/notify/direct-debit"
  }
}

Response Failure Example see reference

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